API Reference: Options Chain and Greeks
Details
Docs navigation
- Getting started: Quickstart, Authentication, Rate limits, Errors and retries
- Guides: Symbol formats, Timestamps and time zones, Pagination, Split and dividend adjustments, WebSocket streaming, Dataset downloads, Excel and Google Sheets, Changelog
- API reference: Stock bars, Stock trades and quotes, Snapshots and movers, Tickers, exchanges, calendar, Splits and dividends, Fundamentals and SEC filings, Options chain and Greeks (you are here), Options EOD, bars, OI, Forex, Crypto, Crypto derivatives, Futures bars and continuous, Settlements and COT, Indices, Economic data, Technical indicators
- SDKs: Python, JavaScript
The options chain endpoint returns every listed contract for one underlying, or a filtered slice of it, with the current bid and ask, volume, open interest, implied volatility and Greeks in each row. Two smaller endpoints list expirations and contracts so you can build a chain picker. This page is for anyone building an options screen, scanning for trades or pulling Greeks into a risk model.
Early access. Planned v1 endpoints, not live yet. Free: end-of-day chain (prior close) for 5 underlyings a day. Starter ($29/mo): 15-minute delayed chain with Greeks for all underlyings. Pro ($79/mo): real-time chain (non-pro, OPRA fee passed through) and second-order Greeks. Business ($249/mo): real time for commercial internal use. Contract lists are free on every plan.
Details
Option chain
GET https://api.marketdata.co/v1/options/chain
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
underlying_symbol |
string | yes | e.g. AAPL, SPX |
|
expiration_date |
string | no | all | One expiry, YYYY-MM-DD |
expiration_from, expiration_to |
string | no | Expiry range | |
option_type |
string | no | both | call or put |
strike_min, strike_max |
number | no | Strike range | |
moneyness |
number | no | Only strikes within this fraction of the underlying, e.g. 0.1 for plus or minus 10% |
|
root_symbol |
string | no | all | e.g. SPXW to get only SPX weeklies |
greeks |
boolean | no | true |
Include IV and Greeks |
fields |
string | no | all | Field subset |
limit, cursor, format |
no | Paging and output |
Response fields
| Field | Type | Description |
|---|---|---|
symbol |
string | OCC option symbol |
underlying_symbol, root_symbol |
string | Underlying and option root |
timestamp |
string | Snapshot time, ISO 8601 UTC |
expiration_date |
string | YYYY-MM-DD |
strike_price |
number | Strike |
option_type |
string | call or put |
expiration_type |
string | monthly, weekly, quarterly, daily (optional) |
days_to_expiration |
integer | Calendar days |
contract_multiplier |
number | Usually 100 (optional) |
bid, bid_size, ask, ask_size |
number | NBBO and sizes in contracts |
mid |
number | (bid + ask) / 2 |
last_price, last_size, last_trade_timestamp |
Last trade (size and time optional) | |
open, high, low, previous_close |
number | Session stats (optional) |
volume |
number | Contracts traded today |
open_interest |
number | As of the prior OCC report |
underlying_price |
number | Underlying at snapshot |
in_the_money, intrinsic_value, extrinsic_value, break_even_price |
Derived values (optional) | |
implied_volatility |
number | Decimal, 0.27 means 27% |
delta, gamma, theta, vega, rho |
number | Theta per calendar day, vega and rho per 1 point |
is_delayed |
boolean | True when 15-minute delayed |
Example
Example (curl), the December 2026 AAPL monthly, strikes 200 to 260:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.marketdata.co/v1/options/chain?underlying_symbol=AAPL&expiration_date=2026-12-18&strike_min=200&strike_max=260"
Example (Python), a calls and puts table side by side:
import os
import requests
import pandas as pd
r = requests.get(
"https://api.marketdata.co/v1/options/chain",
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
params={"underlying_symbol": "AAPL", "expiration_date": "2026-12-18", "moneyness": 0.1},
)
chain = pd.DataFrame(r.json()["results"])
board = chain.pivot_table(index="strike_price", columns="option_type",
values=["bid", "ask", "implied_volatility", "delta"])
print(board.round(3))
Example response
One contract, illustrative values:
{
"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,
"bid": 6.35,
"ask": 6.45,
"mid": 6.40,
"last_price": 6.41,
"volume": 4812,
"open_interest": 21455,
"underlying_price": 228.40,
"implied_volatility": 0.271,
"delta": 0.478,
"gamma": 0.0225,
"theta": -0.129,
"vega": 0.261,
"rho": 0.087,
"is_delayed": false
}
Details
Expirations and contracts
GET https://api.marketdata.co/v1/options/expirations?underlying_symbol=AAPL returns the list of expiry dates with expiration_type.
GET https://api.marketdata.co/v1/options/contracts?underlying_symbol=SPX returns one row per contract with symbol, root_symbol, expiration_date, strike_price, option_type, exercise_style (american or european), settlement_type (physical or cash), contract_multiplier, min_price_increment, is_active and is_adjusted. Pass is_active=false to include expired contracts.
API
Errors for these endpoints
| HTTP | error.code |
When |
|---|---|---|
| 400 | missing_parameter |
No underlying_symbol |
| 400 | invalid_parameter |
strike_min above strike_max, or a past expiration_date on the live chain |
| 403 | plan_required |
Sixth underlying of the day on Free, or real time below Pro |
| 404 | symbol_not_found |
No listed options for this underlying |
Watch out
Notes and gotchas
- A full SPX chain has many thousands of contracts. Filter by expiry and
moneynessinstead of paging through everything. open_interestis published by OCC once a day, before the open. It does not change during the session.midis not a fill price. Wide markets on far strikes makemid, IV and Greeks unreliable; checkbidandaskbefore trusting them.- IV and Greeks come from the mid price, using a binomial model for American-style options and Black-Scholes for European index options.
- Contracts adjusted after a split or merger have
is_adjusted: true, often a new root, and a deliverable that is not 100 shares. Exclude them from screens. - For historical chains, use the options EOD endpoint.
Keep reading
Next steps
Details
Was this page useful?
[Yes] [No]
Want another filter on the chain? Tell us on the custom data form.