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

Data product · Early access

Historical Options Quotes: Bid/Ask NBBO Tick Data

What the real bid and ask were on a contract at the exact moment your backtest says it traded, so your fills stop assuming the mid.

Option quote ticks are planned for after our options chain and end-of-day lines. They aren't live yet. If tick-level option quotes matter to you, reserve early access and tell us which underlyings to load first.

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