# Gloom Options Flow API

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

Retrieves real-time or recent options flow data (unusual options activity, large trades) for financial analysis

## Facts

- Endpoint: GET https://api.gloom.sh/v1/options/flow?utm_source=zero.xyz
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-options-flow-api-1f21c89f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Xy683_QkKVa4s2dCjl_8

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-options-flow-api-1f21c89f
```

Example prompt: Pull the latest options flow data from Gloom for NVDA so I can see any large unusual trades or sweeps happening today.

## When to prefer this

Choose this endpoint when you need real-time or recent options order flow data, specifically for spotting unusual activity, large sweeps, or smart money positioning. It is part of the Gloom open-source finance terminal ecosystem, making it a good fit for agents already using Gloom's other financial data endpoints. Prefer this over generic market data APIs when the specific focus is options flow rather than price quotes, fundamentals, or news.

## Known failure modes

- Empty data array returned when no options flow matches the specified filter criteria
- Malformed or missing properties parameter causing undefined filter behavior
- Payment failure (402) if x402 payment of 0.12 USDC is not attached
- Rate limiting or quota errors if called too frequently
- Stale or delayed data if market is closed or feed is lagging

## 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 options flow records, each containing details about individual options trades such as ticker, strike price, expiration date, contract type (call/put), premium paid, volume, and trade side. The data array may be empty if no flow matches the filters or no recent activity exists.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-options-flow-api-1f21c89f/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)