Coverage
What you get
| Item | Detail |
|---|---|
| Product code | OPT-VOLUME-BREAKDOWN |
| Coverage | US listed options, by contract or rolled up by underlying |
| Granularity | Daily per contract |
| History | As far back as our option trade and quote history goes |
| Delivery | REST, inside the Pro plan |
| Update speed | After the close |
We classify each option trade by comparing its price with the NBBO at the moment it printed. At or above the ask counts as ask_side_volume, at or below the bid as bid_side_volume, anything between as mid_volume. Trades we can't classify, for example because the quote was crossed, go into no_side_volume so the totals still add up.
The title mentions trader type. Be clear about that part: we do not plan to sell volume by participant (customer, professional, firm, market maker) or by opening and closing. That data comes from a single exchange group under its own licence, at a price far above any plan we offer. The two participant fields stay in the schema only so the shape matches if that changes.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
date |
string | yes | YYYY-MM-DD |
symbol |
string | yes | OCC option symbol (or underlying for roll-ups) |
underlying_symbol |
string | yes | Underlying ticker |
total_volume |
number | yes | Contracts |
ask_side_volume |
number | yes | At or above ask |
bid_side_volume |
number | yes | At or below bid |
mid_volume |
number | yes | Between bid and ask |
no_side_volume |
number | optional | Could not be classified |
sweep_volume |
number | optional | Part of sweeps |
floor_volume |
number | optional | Floor trades |
cross_volume |
number | optional | Crosses |
multi_leg_volume |
number | optional | Complex orders |
customer_open_buy_volume |
number | optional | Participant field, not offered |
market_maker_buy_volume |
number | optional | Participant field, not offered |
Example record:
{
"date": "2026-11-18",
"symbol": "AAPL261218C00230000",
"underlying_symbol": "AAPL",
"total_volume": 7930,
"ask_side_volume": 3410,
"bid_side_volume": 2855,
"mid_volume": 1502,
"no_side_volume": 163,
"sweep_volume": 1240,
"floor_volume": 310,
"cross_volume": 0,
"multi_leg_volume": 1975
}
This is an example. Ask, bid, mid and no-side add to 7,930, the same as total_volume.
Sample data
Sample data
There's no free sample of this breakdown yet. It's derived from OPRA trades and quotes, which we license, and we'll publish one when the flow product is built. Request a file for a specific underlying and day.
Use cases
Use cases
Net buying pressure. ask_side_volume - bid_side_volume across all calls on an underlying gives a rough read of whether calls were being bought or sold. Do the same for puts and compare.
Sweep activity. sweep_volume counts contracts filled across several exchanges in one go, which usually means someone wanted size quickly. Track sweeps as a share of total_volume per day.
Filtering out spreads. A big print can be one leg of a spread. Subtract multi_leg_volume before reading direction into a contract's volume.
Earnings positioning. In the week before earnings, compare ask-side call volume with ask-side put volume on near-dated expiries to see which way traders are leaning.
Code
Code examples
Example: daily breakdown for every AAPL contract with curl.
curl "https://api.marketdata.co/v1/options/volume-breakdown?underlying=AAPL&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, net ask-minus-bid volume for calls and puts.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/options/volume-breakdown",
params={"underlying": "AAPL", "date": "2026-11-18"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
v = pd.DataFrame(resp.json()["results"])
v["right"] = v["symbol"].str[-9] # "C" or "P" in an OCC symbol
v["net"] = v["ask_side_volume"] - v["bid_side_volume"]
print(v.groupby("right")[["total_volume", "net", "sweep_volume"]].sum())
Pricing
Pricing
| Plan | Volume breakdown |
|---|---|
| Pro, $79/mo | Side split (ask, bid, mid) and trade-type split (sweep, floor, cross, multi-leg), alongside options flow |
Participant data is not offered. The breakdown isn't sold as a separate dataset. Prices are early access and may change.
Vendors we studied charge $99 to $12,000 a month for this kind of data, based on 2 prices. The top of that range is participant data straight from an exchange.
Side by side
How we compare
Only 2 of the 50 providers we studied sell volume broken down this way. One sells the side split for retail flow traders, the other sells participant data to institutions at exchange prices. We cover the side and trade-type split inside Pro, document how we classify each trade, and keep no_side_volume visible instead of quietly spreading it across the other buckets.
FAQ
Frequently asked questions
How do you decide if a trade was a buy or a sell?
We compare the trade price with the NBBO at the time of the trade. At or above the ask is ask side, at or below the bid is bid side, between is mid.
Do you have customer versus market maker volume?
No, and we don't plan to at launch. That split exists only as a licensed exchange product priced for institutions.
What time zone is the date in?
date is the US trading date. Trades are classified using UTC timestamps, then grouped by the Eastern trading day.
Are volumes adjusted for splits?
Volumes are contract counts as traded. After a split, the OCC adjusts contracts and may issue new symbols, which our contract reference tracks.
Is it real-time?
No. The breakdown is planned as a daily figure after the close. Live trade-by-trade flow is a separate part of the options flow product.
What format does it come in?
JSON from the REST API, one row per contract per day, or one per underlying for roll-ups.
Keep reading
Related
- Asset hub: Options
- Docs: API reference: options history
- Learn: Reading options flow, Open interest explained