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.
Checked
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 | ATM IV12.7% | 25Δ put IV14.2% | 25Δ call IV11.9% |
The first expiry as JSON5 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/flowOptions trade flow | 4 credits a call |
| /v1/options/ivHistorical implied volatility for an underlying symbol | 4 credits a call |
| /v1/options/surfacesImplied volatility across strikes and expiries | 50 credits a call |
| /v1/options/chainsOption calls and puts for a specified expiry | 50 credits a call |
| /v1/options/barsOne option contract's daily bars | 4 credits a call |
| /v1/options/gammaRetained dealer gamma positioning for one expiry | 50 credits a call |
Parameters by route6 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 carries8 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 https://api.gloom.sh/v1/options/flow \
-H "Authorization: Bearer $GLOOM_DATASETS_KEY"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())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. The options dataset reference 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
Look at the data first

OPX SPY shows open interest by strike, max pain and dealer gamma, free. FLOW, the options flow pane, is on Gloom Pro. Weighing it against Unusual Whales? See where each one fits.
Limits5 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.
Sources4 sources
- Gloom Datasets OpenAPI document 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 plans, credits and the founding offer, read 17 October 2026
- Options positioning (OPX) what the free pane shows