Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-EOD |
| Coverage | US-listed equity, ETF and index options, expired contracts included |
| Granularity | Daily, one record per contract |
| History | Free: 1 year. Starter: 5 years. Pro and up: full history we hold. How far back the archive goes depends on the source we sign, and we'll publish exact dates before launch |
| Delivery | REST, bulk endpoints on Business, CSV files you download and keep |
| Update speed | Once a day after the close |
Expired contracts are the whole point. A backtest that only sees today's listed options can't test anything, and a lot of free sources drop contracts the day they expire.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
date |
string | yes | Trading date, YYYY-MM-DD |
symbol |
string | yes | OCC option symbol |
underlying_symbol |
string | yes | Underlying ticker |
root_symbol |
string | optional | Option root |
expiration_date |
string | yes | YYYY-MM-DD |
strike_price |
number | yes | Strike |
option_type |
string | yes | call or put |
days_to_expiration |
integer | optional | Calendar days to expiry |
open |
number | yes | First trade price (null if no trades) |
high |
number | yes | Highest trade |
low |
number | yes | Lowest trade |
close |
number | yes | Last trade price of the day |
volume |
number | yes | Contracts traded |
trade_count |
number | optional | Number of trades |
vwap |
number | optional | Volume-weighted average price |
close_bid |
number | yes | Bid at the closing snapshot |
close_bid_size |
number | optional | Bid size at close |
close_ask |
number | yes | Ask at the closing snapshot |
close_ask_size |
number | optional | Ask size at close |
close_mid |
number | optional | Mid at close |
snapshot_time |
string | optional | Time the closing quote was taken, ISO 8601 UTC |
open_interest |
number | yes | Open interest at start of day (OCC) |
open_interest_change |
number | optional | Change from prior day |
underlying_close |
number | yes | Underlying close (or price at snapshot) |
implied_volatility |
number | optional | IV at close mid |
delta |
number | optional | Greeks at close (see OPT-GREEKS-IV) |
gamma |
number | optional | |
theta |
number | optional | |
vega |
number | optional | |
rho |
number | optional |
Example record:
{
"date": "2026-11-18",
"symbol": "AAPL261218C00230000",
"underlying_symbol": "AAPL",
"root_symbol": "AAPL",
"expiration_date": "2026-12-18",
"strike_price": 230.0,
"option_type": "call",
"days_to_expiration": 30,
"open": 5.90,
"high": 6.62,
"low": 5.81,
"close": 6.48,
"volume": 7930,
"trade_count": 1184,
"vwap": 6.27,
"close_bid": 6.45,
"close_bid_size": 61,
"close_ask": 6.55,
"close_ask_size": 40,
"close_mid": 6.50,
"snapshot_time": "2026-11-18T21:00:00Z",
"open_interest": 21455,
"open_interest_change": 1312,
"underlying_close": 228.61,
"implied_volatility": 0.270,
"delta": 0.484,
"gamma": 0.0226,
"theta": -0.128,
"vega": 0.261,
"rho": 0.088
}
Sample data
Sample data
There's no free historical options sample yet. US options prices are OPRA data, and we need the licence before we can share any. A sample file is available on request for one underlying and a date range you choose.
Use cases
Use cases
Backtesting with honest fills. Use close_bid when you sell and close_ask when you buy. Most contracts don't trade at 16:00, so close can be hours stale; the closing quote in snapshot_time is what you'd actually have seen.
Wheel and covered-call studies. Each day, pick the call with delta near 0.30 and about 30 days_to_expiration, then follow that symbol through to expiry. Expired contracts stay in the data, so the follow-through works.
IV history per stock. Take the at-the-money implied_volatility for the nearest monthly expiry each day and you have an IV series to compare against realised volatility from underlying_close.
Positioning changes. open_interest_change shows where contracts were opened or closed overnight, strike by strike.
Code
Code examples
Example: every TSLA contract on one date.
curl "https://api.marketdata.co/v1/options/eod?underlying=TSLA&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, follow one contract from listing to expiry.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/eod",
params={"symbol": "AAPL261218C00230000"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
hist = pd.DataFrame(resp.json()["results"]).set_index("date").sort_index()
print(hist[["close_bid", "close_ask", "implied_volatility", "delta", "open_interest"]].tail(10))
Pricing
Pricing
| Plan | Historical options |
|---|---|
| Free, $0 | 1 year, 5 underlyings a day, 5 requests a minute |
| Starter, $29/mo | 5 years, all underlyings |
| Pro, $79/mo | Full history we hold |
| Business, $249/mo | Full history, commercial internal use, bulk endpoints |
Files are the cheaper route for most backtests. Planned dataset prices: $19 per underlying for full history, $149 per year of the full US market, $599 for the full archive for personal use, and $49 a month for daily updates. Greeks and IV are included in every file. Prices are early access and may change.
For comparison, monthly plans with historical options run from $0 to $3,000 across 12 prices we found, median $59.50, and the best-known one-off archive sells for $599.
Side by side
How we compare
14 of the 50 providers we studied sell end-of-day options history. The options flow sites sell no files at all, and some chain APIs don't store historical Greeks. We sell per-underlying files at a listed price, put Greeks and IV in every row, and state the time of the closing quote in snapshot_time because vendors take it at different times and rarely say so.
FAQ
Frequently asked questions
When is the closing quote taken?
It's recorded on every row in snapshot_time, in UTC. You never have to guess which minute the bid and ask came from.
Are expired contracts included?
Yes. Every contract stays in the history after it expires, which is what makes strategy backtests possible.
How are prices adjusted after a stock split?
Option contracts are adjusted by OCC, not by us. After a split the contract may get a new root_symbol and a non-standard deliverable, and the record keeps the prices exactly as they traded.
Are Greeks included in the files?
Yes, implied_volatility, delta, gamma, theta, vega and rho at the closing mid, at no extra cost.
What licence covers the files?
Dataset purchases are for personal use. Commercial use of the archive is licensed separately and quoted.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Implied volatility and IV rank, OCC option symbols