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

Data product · Early access

Options Volume by Trade Side and Trader Type

Of the 7,930 contracts that traded, how many were bought at the ask, sold at the bid, or crossed somewhere in between.

This breakdown is planned for later. It will arrive as part of our options flow product, once option trades and quotes are in place. Nothing is live yet, but you can reserve early access today.

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