Gloom Datasets

# Options flow API

Stored options flow, implied volatility surfaces, option chains and dealer gamma over one REST key. News and our own data includes them, from $199 a month.

- [Get a key](https://gloom.sh/datasets/pricing)
- Try the sample

Checked 17 October 2026

## Try it without a key

```
curl https://api.gloom.sh/v1/datasets/options/sample
```

| Expiry | ATM IV | 25Δ put IV | 25Δ call IV |
| --- | --- | --- | --- |
| 6 November 2026 | 12.7% | 14.2% | 11.9% |

_Real response from /v1/options/surfaces: SPY, captured 8 October 2026. Implied volatility at the money and at 25 delta (25Δ), for the one expiry it priced._

- **The first expiry as JSON (5 fields)**

  ```
  {
    "expiration": 1793923200,
    "years": 0.07991755,
    "forward": 775.6269,
    "atmIV": 0.126587,
    "skew": {
      "atm": 0.126587000116,
      "put25": 0.141791148747,
      "call25": 0.118896006031,
      "putCallSkew": 0.0228951427152,
      "riskReversal": -0.0228951427152,
      "butterfly": 0.00375657727322,
      "moneynessSkew": 0.0839814407755
    }
  }
  ```

## Routes and credits

| Route | Credits a call |
| --- | --- |
| /v1/options/flow Options trade flow | 4 credits a call |
| /v1/options/iv Historical implied volatility for an underlying symbol | 4 credits a call |
| /v1/options/surfaces Implied volatility across strikes and expiries | 50 credits a call |
| /v1/options/chains Option calls and puts for a specified expiry | 50 credits a call |
| /v1/options/bars One option contract's daily bars | 4 credits a call |
| /v1/options/gamma Retained dealer gamma positioning for one expiry | 50 credits a call |

- **Parameters by route (6 routes)**

  /v1/options/flow: symbols?, limit?, cursor?, before?, asOf?, fields?

  /v1/options/iv: symbols, from?, to?, asOf?, fields?

  /v1/options/surfaces: symbols, date?, fields?

  /v1/options/chains: symbols, expiry, limit?, cursor?, fields?, include?

  /v1/options/bars: contract, from?, to?, asOf?, fields?, include?

  /v1/options/gamma: symbols, expiry, fields?, include?

  A ? marks an optional parameter.
- **What a flow print carries (8 fields)**

  - **underlying, contract**: The stock and the option contract
  - **right, strike, expiry**: Call (C) or put (P), strike and expiry date
  - **kind**: sweep, block, split or trade
  - **side**: ask, bid, mid or unknown
  - **size, price, premium**: Contracts traded, price per contract, premium
  - **volume, openInterest, volOi**: The contract's day volume, open interest and their ratio
  - **iv**: Implied volatility, when known
  - **at, id**: When it printed, in milliseconds, and the print's id

## Call it with a key

**curl**

```
curl https://api.gloom.sh/v1/options/flow \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"
```

**Python**

```
import os
import requests

response = requests.get(
    "https://api.gloom.sh/v1/options/flow",
    headers={"Authorization": f"Bearer {os.environ['GLOOM_DATASETS_KEY']}"},
)
response.raise_for_status()
print(response.json())
```

**TypeScript**

```
const response = await fetch(
  "https://api.gloom.sh/v1/options/flow",
  { headers: { Authorization: `Bearer ${process.env.GLOOM_DATASETS_KEY}` } },
)
if (!response.ok) throw new Error(await response.text())
console.log(await response.json())
```

Create a key in the [Datasets console](https://gloom.sh/datasets/console). The [options dataset reference](https://gloom.sh/datasets/docs/datasets/options) has every route.

## Plans

| Plan | Personal use | Company use |
| --- | --- | --- |
| Reference | $49/mo | $149/mo |
| Filings and research | $99/mo | $299/mo |
| News and our own data | $199/mo | $799/mo |
| Everything | $299/mo | $1,199/mo |

To show the data on your own site or app, from $1,000 a month. Founding offer: 25% off every plan for 12 months, for the first 100 paid accounts or until 4 December 2026. [Datasets pricing](https://gloom.sh/datasets/pricing)

## Look at the data first

![OPX for SPY: open interest by strike with max pain and spot, and the strike table](https://gloom.sh/screenshots/fn/OPX.png)

`OPX SPY` shows open interest by strike, max pain and dealer gamma, free. `FLOW`, the [options flow pane](https://gloom.sh/features/options-flow), is on Gloom Pro. Weighing it against Unusual Whales? See [where each one fits](https://gloom.sh/alternatives/unusual-whales).

- [Open the terminal in your browser, no account](https://term.gloom.sh/?ticker=NVDA)
- [Gloom Pro and the free plan](https://gloom.sh/cloud#pricing)

- **Limits (5 items)**

  - Flow: newest prints first, 100 a page by default and up to 200. Page back with meta.next, or send meta.page.nextCursor as cursor.
  - Implied volatility history covers the last 366 days.
  - A chain is one expiry, with calls and puts at up to 500 strikes a side a page, the lowest first: page up with meta.next. On an index expiry two roots share, it lists both roots' contracts at a strike.
  - Gamma reads a snapshot the server already holds for that expiry: with none held, it returns 503. A missing stored surface returns 404.
  - Dealer gamma is an estimate of dealer positioning, not measured holdings.
- **Sources (4 sources)**

  - [Gloom Datasets OpenAPI document](https://gloom.sh/datasets/openapi.json) routes, parameters and credits, read 17 October 2026
  - curl https://api.gloom.sh/v1/datasets/options/sample the SPY surface captured 8 October 2026
  - [Datasets pricing](https://gloom.sh/datasets/pricing) plans, credits and the founding offer, read 17 October 2026
  - [Options positioning (OPX)](https://gloom.sh/docs/options-positioning) what the free pane shows

## Related

- [Options dataset](https://gloom.sh/datasets/options)
- [What is options flow?](https://gloom.sh/academy/options-and-volatility/positioning-and-flow/options-flow)
- [Unusual Whales alternatives](https://gloom.sh/alternatives/unusual-whales)
- [Finance MCP server](https://gloom.sh/mcp)
- [Alternative data for funds](https://gloom.sh/alternative-data)
