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

Data product · Early access

Options Contracts, Expirations and Strikes API

The list of every option contract that exists, or used to exist, for an underlying: expirations, strikes, OCC symbols, exercise style and settlement. Free on every plan.

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