Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-TRADES |
| Coverage | All US-listed options trades reported to OPRA |
| Granularity | Every trade, nanosecond timestamps |
| History | Pro: 5 years by contract. Business: full history |
| Delivery | REST for history, WebSocket for the live stream on Business, files by day or by underlying |
| Update speed | Delayed live trades on Pro, real time on Business |
The raw OPRA tape tells you price, size and venue. That isn't enough to read it. Whether a 500-lot was bought or sold depends on where it printed against the bid and ask, so we stamp nbbo_bid and nbbo_ask on every trade and classify it in side.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
timestamp |
string | yes | Exchange (SIP) time, ISO 8601 UTC, nanoseconds |
receive_timestamp |
string | optional | Our receive time |
symbol |
string | yes | OCC option symbol |
underlying_symbol |
string | yes | Underlying ticker |
price |
number | yes | Trade price |
size |
number | yes | Contracts |
premium |
number | yes | price x size x multiplier, USD |
exchange |
string | yes | Exchange code (MIC) |
conditions |
array of string | yes | OPRA condition codes |
sequence_number |
number | yes | OPRA sequence |
nbbo_bid |
number | yes | NBBO bid at trade time |
nbbo_ask |
number | yes | NBBO ask at trade time |
side |
string | optional | above_ask, ask, mid, bid, below_bid |
underlying_price |
number | optional | Underlying mid at trade time |
implied_volatility |
number | optional | IV at trade price |
delta |
number | optional | Delta at trade time |
Example record:
{
"timestamp": "2026-11-18T18:41:55.103482911Z",
"receive_timestamp": "2026-11-18T18:41:55.104117350Z",
"symbol": "AAPL261218C00230000",
"underlying_symbol": "AAPL",
"price": 6.45,
"size": 25,
"premium": 16125.0,
"exchange": "XCBO",
"conditions": ["I"],
"sequence_number": 884213077,
"nbbo_bid": 6.35,
"nbbo_ask": 6.45,
"side": "ask",
"underlying_price": 228.40,
"implied_volatility": 0.274,
"delta": 0.479
}
Sample data
Sample data
There's no free options tick sample yet. OPRA trades can't be redistributed without the licence we're still arranging. A sample file is available on request for one underlying and one day.
Use cases
Use cases
Building your own flow scanner. Filter on premium above $100,000 and side = above_ask or ask. You'll get the aggressive buys that most paid flow tools show, and you can set your own thresholds.
Execution research. Compare price with nbbo_bid and nbbo_ask across exchanges to see where trades print inside the spread, and on which exchange.
Volatility at the trade. implied_volatility and delta at trade time let you sum delta-weighted volume by strike, which is a cleaner measure of directional flow than raw contract counts.
Rebuilding bars your way. Every bar product is built from trades. With the ticks you choose the interval, the stamp convention and which conditions to exclude, such as cancelled or late prints.
Code
Code examples
Example: trades in one contract for a day.
curl "https://api.marketdata.co/v1/options/trades?symbol=AAPL261218C00230000&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, premium bought at or above the ask, by strike.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/trades",
params={"underlying": "AAPL", "date": "2026-11-18", "min_premium": 50000},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
t = pd.DataFrame(resp.json()["results"])
aggressive = t[t["side"].isin(["ask", "above_ask"])]
print(aggressive.groupby("symbol")["premium"].sum().sort_values(ascending=False).head(10))
Pricing
Pricing
| Plan | Options trades |
|---|---|
| Pro, $79/mo | Historical trades by contract (5 years) with NBBO and side; delayed live trades |
| Business, $249/mo | Real-time WebSocket of all trades, full history, commercial internal use |
Planned files: $25 per full-market trading day, or $49 per underlying per year. Prices are early access and may change.
Across 9 prices we found, plans with options trade data run from $0 to $2,000 a month, median $149.99.
Side by side
How we compare
14 of the 50 providers we studied sell option trade ticks. Fewer attach the NBBO and an aggressor side, and fewer still sell a day or an underlying as a file at a listed price. We do all three, and the trade record uses the same contract symbol, UTC nanosecond timestamps and premium definition as our options flow data.
FAQ
Frequently asked questions
How is side decided?
By comparing the trade price with nbbo_bid and nbbo_ask at trade time. At the ask is ask, through it is above_ask, between them is mid, and so on down to below_bid.
What do the condition codes mean?
They're OPRA's own trade condition codes, passed through unchanged. They mark things like late reports, cancels and multi-leg trades, which many studies exclude.
How is premium calculated?
price times size times the contract multiplier, in USD. A 10-lot at $6.41 on a standard contract is $6,410.
What time zone are timestamps in?
UTC with nanosecond precision. timestamp is the exchange time; receive_timestamp, when present, is when we got it.
How big is a day of data?
Large. The full market for one day runs to millions of trades, which is why we sell it per day or per underlying rather than as one archive.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history, WebSocket streaming
- Learn: Reading options flow, Tick data vs bar data