Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-QUOTES |
| Coverage | US listed options, by OCC contract symbol |
| Granularity | Every change to the national best bid and offer |
| History | 2 years on Business; longer on Enterprise |
| Delivery | REST by contract; WebSocket for up to 1,000 contracts; files per underlying-day |
| Update speed | Live over WebSocket on Business |
OPRA quote traffic is enormous. On a busy day, the options market changes its best quotes billions of times, far more than the stock market. That's why most vendors who carry it charge a lot, and why we start with per-contract history instead of a full-market firehose.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
timestamp |
string | yes | SIP time, ISO 8601 UTC, nanoseconds |
receive_timestamp |
string | optional | Our receive time |
symbol |
string | yes | OCC option symbol |
bid |
number | yes | Best bid |
bid_size |
number | yes | Contracts at bid |
bid_exchange |
string | yes | Exchange code of best bid |
ask |
number | yes | Best ask |
ask_size |
number | yes | Contracts at ask |
ask_exchange |
string | yes | Exchange code of best ask |
conditions |
array of string | optional | Quote condition codes |
sequence_number |
number | optional | OPRA sequence |
Example record:
{
"timestamp": "2026-11-18T18:41:55.098331204Z",
"receive_timestamp": "2026-11-18T18:41:55.098902117Z",
"symbol": "AAPL261218C00230000",
"bid": 6.35,
"bid_size": 42,
"bid_exchange": "XISX",
"ask": 6.45,
"ask_size": 58,
"ask_exchange": "XCBO",
"conditions": ["R"],
"sequence_number": 884212950
}
The record is an example. AAPL261218C00230000 reads as an AAPL call, expiring 18 December 2026, strike $230.
Sample data
Sample data
We don't have a free option quote sample. Quotes come from OPRA under licence, and the files are large, so samples go out on request. Tell us the underlying, a few strikes and a date.
Use cases
Use cases
Realistic fills. Join your simulated trades to the last quote before each timestamp. Buying at ask and selling at bid instead of the mid often turns a winning short-premium strategy into a break-even one.
Spread cost by time of day. Compute (ask - bid) / ((ask + bid) / 2) per minute. Spreads on most names are widest in the first minutes after the open, which tells you when not to trade.
Liquidity at size. bid_size and ask_size show how many contracts sat at the inside. If you trade 50 lots and the inside shows 5, your real fill price is worse than the NBBO.
Venue analysis. bid_exchange and ask_exchange show which exchange was setting the best price. Market makers and routing researchers use this to see where liquidity really sits per underlying.
Code
Code examples
Example: quotes for one contract over one minute with curl.
curl "https://api.marketdata.co/v1/options/quotes?symbol=AAPL261218C00230000&start=2026-11-18T18:41:00Z&end=2026-11-18T18:42:00Z" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, median quoted spread per minute.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/quotes",
params={"symbol": "AAPL261218C00230000",
"start": "2026-11-18T14:30:00Z", "end": "2026-11-18T21:00:00Z"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
q = pd.DataFrame(resp.json()["results"])
q["timestamp"] = pd.to_datetime(q["timestamp"])
q["mid"] = (q["bid"] + q["ask"]) / 2
q["spread_pct"] = (q["ask"] - q["bid"]) / q["mid"]
print(q.set_index("timestamp")["spread_pct"].resample("1min").median().head(30))
A full session for one liquid contract can run to hundreds of thousands of rows, so page through with next_cursor from the response.
Pricing
Pricing
| Plan | Option quotes |
|---|---|
| Business, $249/mo | Historical NBBO by contract (2 years), live quotes over WebSocket for up to 1,000 contracts |
| Enterprise, quote | Full history and full-market feed |
Per underlying-day quote files are planned at $15 each. Full-market quote files are quote-only because of their size. Prices are early access and may change.
Vendors we studied charge $0 to $2,000 a month for option quotes, median $199, based on 5 prices.
Side by side
How we compare
8 of the 50 providers we studied sell option quote history, mostly to quant teams. We plan to price per underlying-day, so you can buy SPY quotes for the five days you care about without a year-long lease. Field names match our option trades and chains, and the files you buy are yours to keep.
FAQ
Frequently asked questions
Is this every quote or only the NBBO?
The NBBO: the best bid and offer across all exchanges, with the exchange that set each side. Per-exchange quotes are not planned at launch.
How far back will history go?
Two years on Business. Longer history is available on Enterprise by quote.
What time zone are timestamps in?
UTC with nanosecond precision. timestamp is the SIP time, and receive_timestamp is when our system got the message.
Are quotes adjusted after a split?
No. Quotes stay as they were at the time. After a split the OCC may adjust contract terms, and the symbol can change; our contracts reference handles the mapping.
Can I use quotes in a product I sell?
Not on Business. Redistributing OPRA data needs its own licence, which we handle on Enterprise.
What file formats will you offer?
JSON from the API, and compressed CSV or Parquet for underlying-day files.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: NBBO explained, OCC option symbols