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
Related
- Asset hub: Options
- Docs: API reference: options chain
- Learn: Options Greeks explained, OCC option symbols