Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Options Chain API with Greeks

Every listed strike and expiration for an underlying in one response, with the bid, ask, volume, open interest, implied volatility and Greeks a trader looks at before placing an order.

Coverage

What you get

Item Detail
Product code OPT-CHAIN
Coverage US-listed equity, ETF and index options, OCC symbology
Granularity Latest snapshot per contract, filterable by expiration, strike range and type
History A snapshot by nature. Historical chains are sold as end-of-day options data
Delivery REST, with WebSocket on the roadmap for real-time plans
Update speed Prior close on Free, 15-minute delayed on Starter, real time from Pro

A chain response is wide. We return every contract as a flat record rather than nesting calls and puts under strikes, so the whole thing drops straight into a DataFrame and you filter it there.

Schema

Schema

Field Type Required Description
symbol string yes OCC option symbol, e.g. AAPL261218C00230000
underlying_symbol string yes Underlying ticker, e.g. AAPL
root_symbol string optional Option root (differs from underlying after adjustments, e.g. SPXW)
timestamp string yes Time of the snapshot, ISO 8601 UTC
expiration_date string yes YYYY-MM-DD
strike_price number yes Strike in USD
option_type string yes call or put
expiration_type string optional monthly, weekly, quarterly, daily
days_to_expiration integer yes Calendar days to expiry
contract_multiplier number optional Usually 100
bid number yes Best bid (NBBO)
bid_size number yes Contracts at the bid
ask number yes Best ask (NBBO)
ask_size number yes Contracts at the ask
mid number yes (bid + ask) / 2, called mark by some vendors
last_price number yes Last trade price
last_size number optional Last trade size
last_trade_timestamp string optional Time of last trade
open number optional Session open
high number optional Session high
low number optional Session low
previous_close number optional Prior session close
volume number yes Contracts traded today
open_interest number yes Open interest as of the prior OCC report
underlying_price number yes Underlying price at snapshot
in_the_money boolean optional True if the contract has intrinsic value
intrinsic_value number optional Max(0, underlying minus strike) for calls, reverse for puts
extrinsic_value number optional mid minus intrinsic_value
break_even_price number optional strike plus mid (call) or minus mid (put)
implied_volatility number optional Decimal, 0.27 = 27%
delta number optional See OPT-GREEKS-IV
gamma number optional
theta number optional Per calendar day
vega number optional Per 1 vol point
rho number optional Per 1 rate point
is_delayed boolean yes True when the record is 15-minute delayed

Example record:

{
  "symbol": "AAPL261218C00230000",
  "underlying_symbol": "AAPL",
  "root_symbol": "AAPL",
  "timestamp": "2026-11-18T18:42:07.512000Z",
  "expiration_date": "2026-12-18",
  "strike_price": 230.0,
  "option_type": "call",
  "expiration_type": "monthly",
  "days_to_expiration": 30,
  "contract_multiplier": 100,
  "bid": 6.35,
  "bid_size": 42,
  "ask": 6.45,
  "ask_size": 58,
  "mid": 6.40,
  "last_price": 6.41,
  "last_size": 3,
  "last_trade_timestamp": "2026-11-18T18:41:55.103000Z",
  "open": 5.90,
  "high": 6.62,
  "low": 5.81,
  "previous_close": 5.97,
  "volume": 4812,
  "open_interest": 21455,
  "underlying_price": 228.40,
  "in_the_money": false,
  "intrinsic_value": 0.0,
  "extrinsic_value": 6.40,
  "break_even_price": 236.40,
  "implied_volatility": 0.271,
  "delta": 0.478,
  "gamma": 0.0225,
  "theta": -0.129,
  "vega": 0.261,
  "rho": 0.087,
  "is_delayed": false
}

Sample data

Sample data

No free chain sample yet. Live US options prices come from OPRA, and we can't share them until that agreement is in place. A sample file is available on request: name an underlying and we'll send a chain snapshot in this schema when we can.

Use cases

Use cases

Picking a strike by delta. Filter option_type = call, a single expiration_date, and take the contract with delta closest to 0.30. That's how most covered-call and short-put sellers choose strikes, and it takes two lines of pandas.

Checking liquidity before you trade. ask minus bid, relative to mid, plus open_interest and volume, tells you whether you'll get filled near fair value or pay a dollar of spread on a contract worth six.

Expected move from the straddle. Add the mid of the at-the-money call and put for the nearest expiry. That's roughly the move the market is pricing in by expiration_date, and it's the number traders quote ahead of earnings.

Building your own volatility smile. Plot implied_volatility against strike_price for one expiration. Then do it for the next few and you have a term structure too.

Code

Code examples

Example: the AAPL chain for one expiration, calls only.

curl "https://api.marketdata.co/v1/options/chain?underlying=AAPL&expiration_date=2026-12-18&option_type=call" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, find the 30-delta put for each expiration in the next 60 days.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/options/chain",
    params={"underlying": "AAPL", "option_type": "put", "max_days_to_expiration": 60},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
chain = pd.DataFrame(resp.json()["results"])
chain["dist"] = (chain["delta"] + 0.30).abs()
picks = chain.loc[chain.groupby("expiration_date")["dist"].idxmin()]
print(picks[["symbol", "strike_price", "delta", "bid", "ask", "open_interest"]])

Pricing

Pricing

Plan Options chain
Free, $0 End-of-day chain (prior close), 5 underlyings a day
Starter, $29/mo 15-minute delayed chain with Greeks, all underlyings, 60 requests a minute
Pro, $79/mo Real-time chain (non-professional, OPRA fee passed through), 300 requests a minute
Business, $249/mo Real time, commercial internal use, 1,000 requests a minute

Display and redistribution are Enterprise, priced on request. The chain isn't sold as a dataset; historical chains come with the end-of-day product. Prices are early access and may change.

In our research, entry plans that include a chain run from $0 to $2,499 a month across 13 listed prices, with a median of $99.

Side by side

How we compare

16 of the 50 providers we studied sell an options chain, which makes it the most-sold options product. Many put Greeks on a higher tier or leave out open interest. Ours includes both from Starter, the price is on this page, and the record uses the same field names as our historical options files, so code you write against the live chain runs unchanged on the history.

FAQ

Frequently asked questions

Which options are covered?

US-listed options on stocks, ETFs and indices, identified by OCC symbol. Weekly and daily expirations are included and tagged in expiration_type.

How are Greeks calculated?

We compute them ourselves from the mid price and the underlying, and the model is stated in our Greeks and IV data. theta is per calendar day and vega per one vol point.

When is open interest updated?

Once a day. OCC publishes open interest overnight, so open_interest during the session reflects the prior day's close of business.

What time zone are timestamps in?

UTC in ISO 8601, like every other product we sell. US options trade 14:30 to 21:00 UTC in winter.

Can I show the chain in my app?

Not on Pro, which is licensed for personal, non-professional use. Showing OPRA data to others requires an Enterprise display licence.

How do I tell delayed from real-time data?

Check is_delayed on every record. It's true for 15-minute delayed data on Starter.

Keep reading