# Gloom Finance Terminal - Catalyst Changes API

> Gloom Finance Terminal - Catalyst Changes API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-01).

Retrieves recent regulatory and approval catalyst changes (e.g. FDA approvals) for financial securities since a given timestamp

## Facts

- Endpoint: GET https://api.gloom.sh/v1/catalysts/changes?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-finance-terminal-catalyst-changes-api-18141973
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kM9_VyVzq_4Zo3hnM9RTj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-finance-terminal-catalyst-changes-api-18141973
```

Example prompt: Pull all regulatory catalyst changes since yesterday from Gloom — I want to see any new FDA approvals or status changes for US equities so I can review them before the market opens.

## When to prefer this

Use this endpoint when you need structured, machine-readable regulatory catalyst events (especially FDA approvals) for equities, filtered by time. Prefer this over news APIs when you want only regulatory/approval-type catalysts with structured metadata (agency, status, jurisdiction, external ID) rather than raw news text. Ideal for quantitative screening, portfolio alert systems, or research tools that need clean, normalized catalyst data.

## Known failure modes

- Missing required 'since' query parameter returns a validation error
- Invalid or malformed date string in 'since' causes a 400 error
- No catalyst changes found for the given time window returns an empty data array
- Rate limiting or payment failure (x402) returns a 402 Payment Required response
- Service downtime returns 503 or connection timeout

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of catalyst change objects, each containing the catalyst type (e.g. 'approval'), the regulatory agency (e.g. 'FDA'), the source database, current status, the affected stock symbol, country, a plain-language summary, a revision number, an external regulatory ID, and the jurisdiction. Results are filtered to events occurring after the provided 'since' timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "since"
     ],
     "properties": {
      "since": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "type": "approval",
    "agency": "FDA",
    "source": "fda_approvals",
    "status": "approved",
    "symbol": "AAPL",
    "country": "US",
    "summary": "Labeling",
    "revision": 1,
    "externalId": "NDA020766:SUPPL:22",
    "jurisdiction": "US"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-finance-terminal-catalyst-changes-api-18141973/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)