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

API Reference: Options Chain and Greeks

Details

Docs navigation

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 moneyness instead of paging through everything.
  • open_interest is published by OCC once a day, before the open. It does not change during the session.
  • mid is not a fill price. Wide markets on far strikes make mid, IV and Greeks unreliable; check bid and ask before 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.