# Gloom Finance Catalysts API

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

Retrieves regulatory and market catalyst events (e.g. FDA approvals, filings) for financial instruments by ticker symbol

## Facts

- Endpoint: GET https://api.gloom.sh/v1/catalysts?utm_source=zero.xyz
- Price: $0.06/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-catalysts-api-cc5651f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a5IwAmjEnncmpwMbdYoB5

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-catalysts-api-cc5651f1
```

Example prompt: Pull up the latest regulatory catalyst events for AAPL from Gloom — I want to see any FDA approvals, agency actions, or filing statuses associated with the ticker.

## When to prefer this

Prefer this endpoint when you need structured regulatory and catalyst event data tied to specific equity tickers, especially for pharmaceutical or biotech research workflows. It is particularly useful when you want FDA approval records, NDA filings, or agency actions linked to a stock symbol in a machine-readable format. Choose this over general financial news APIs when you need structured, sourced catalyst events with external IDs and jurisdictional metadata rather than free-form news articles.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty data array
- Malformed properties filter parameter may return 400 Bad Request
- No catalyst data available for the requested symbol returns empty results
- Payment not provided or insufficient USDC balance returns 402 Payment Required
- Rate limiting may return 429 Too Many Requests

## 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 a JSON array of catalyst event objects, each containing the event type (e.g. 'approval'), the regulatory agency (e.g. 'FDA'), the data source, approval status, the associated stock ticker, country and jurisdiction, a plain-language summary, a revision number, and an external identifier (e.g. NDA application number).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## 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-catalysts-api-cc5651f1/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)