Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-REFERENCE |
| Coverage | US-listed equity, ETF and index options, active and expired |
| Granularity | One record per contract |
| History | Expired contracts back to the start of our options history |
| Delivery | REST, plus a daily CSV of currently listed contracts |
| Update speed | Daily, as contracts are listed, expire or get adjusted |
Every options tool starts here. Before you can request a chain, draw an expiry picker or look up a contract's history, you need the list of what's listed. It costs us little to serve, so we don't charge for it.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | OCC option symbol |
underlying_symbol |
string | yes | Underlying ticker |
root_symbol |
string | yes | Option root |
expiration_date |
string | yes | YYYY-MM-DD |
strike_price |
number | yes | Strike |
option_type |
string | yes | call or put |
exercise_style |
string | yes | american or european |
settlement_type |
string | optional | physical or cash |
expiration_type |
string | optional | monthly, weekly, quarterly, daily |
contract_multiplier |
number | yes | Usually 100 |
min_price_increment |
number | optional | Tick size |
currency |
string | optional | USD |
first_traded_date |
string | optional | First listing date |
is_active |
boolean | yes | False once expired or delisted |
is_adjusted |
boolean | optional | True for non-standard deliverables after corporate actions |
Example record:
{
"symbol": "SPXW261218P06500000",
"underlying_symbol": "SPX",
"root_symbol": "SPXW",
"expiration_date": "2026-12-18",
"strike_price": 6500.0,
"option_type": "put",
"exercise_style": "european",
"settlement_type": "cash",
"expiration_type": "weekly",
"contract_multiplier": 100,
"min_price_increment": 0.05,
"currency": "USD",
"first_traded_date": "2025-12-19",
"is_active": true,
"is_adjusted": false
}
Sample data
Sample data
The planned free daily CSV of listed contracts isn't live yet. Until it is, a sample file is available on request for any underlying.
Use cases
Use cases
Expiry pickers. Query distinct expiration_date values for an underlying and group them by expiration_type. SPX has daily expirations as well as monthlies, so your dropdown needs to handle dozens of dates.
Validating OCC symbols. Before you send a request built from user input, check the symbol exists. SPXW261218P06500000 breaks down into root SPXW, expiry 2026-12-18, put, strike 6,500.
Catching adjusted contracts. After a split, merger or special dividend, OCC may change a contract's deliverable. is_adjusted flags those, and they're the contracts that make backtests go wrong if you price them as standard 100-share options.
Index vs equity rules. exercise_style and settlement_type tell you whether you can be assigned early and whether you'll receive shares or cash. SPX options are European and cash-settled; SPY options are American and settle in shares.
Code
Code examples
Example: all active SPX expirations.
curl "https://api.marketdata.co/v1/options/contracts?underlying=SPX&is_active=true&fields=expiration_date,root_symbol,expiration_type" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, strikes listed for one expiry, and any adjusted contracts.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/contracts",
params={"underlying": "AAPL", "expiration_date": "2026-12-18"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
contracts = pd.DataFrame(resp.json()["results"])
print(sorted(contracts["strike_price"].unique()))
print(contracts[contracts["is_adjusted"] == True][["symbol", "root_symbol", "contract_multiplier"]])
Pricing
Pricing
| Plan | Contracts and expirations |
|---|---|
| Free, $0 | Full access, including expired contracts |
| Starter, Pro, Business | Same data, higher rate limits |
The reference list is free on every tier, and the daily CSV of listed contracts is planned as a free download. Rate limits follow your plan.
Vendors charge anything from $0 to $3,000 a month for plans that include contract lists, median $99 across 13 prices, though most paid vendors only charge for it as part of a bundle.
Side by side
How we compare
16 of the 50 providers we studied offer an options contract list. Five of them give it away, and we do too. What we add is expired contracts at no cost, the is_adjusted flag, and the same OCC symbol format across our chain, EOD, trades and Greeks, so the reference list is the key that joins everything else.
FAQ
Frequently asked questions
Do you include expired contracts?
Yes, back to the start of our options history. Filter is_active to false to get only expired ones.
What symbol format do you use?
The OCC format with the padding spaces removed: root, expiry as YYMMDD, C or P, then the strike times 1,000 padded to 8 digits.
Why is the root different from the underlying?
Some products list under several roots. SPX weeklies trade as SPXW, and adjusted contracts often get a new root like AAPL1 after a corporate action.
How often is the list updated?
Daily. Newly listed strikes and expirations appear in the next update, and contracts that expire flip is_active to false.
Do I need a paid plan?
No. Every plan, including Free, gets the full list. Paid plans only raise the rate limit.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options chain, Symbology
- Learn: OCC option symbols