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
6 November 2026ATM IV12.7%25Δ put IV14.2%25Δ call IV11.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 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

/v1/options/flowOptions trade flow4 credits a call
/v1/options/ivHistorical implied volatility for an underlying symbol4 credits a call
/v1/options/surfacesImplied volatility across strikes and expiries50 credits a call
/v1/options/chainsOption calls and puts for a specified expiry50 credits a call
/v1/options/barsOne option contract's daily bars4 credits a call
/v1/options/gammaRetained dealer gamma positioning for one expiry50 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.

Call it with a key

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

Create a key in the Datasets console. The options dataset reference has every route.

Plans

PlanPersonal useCompany 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 for SPY: open interest by strike with max pain and spot, and the strike table

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