Exchange & Trade Code Breakdown

GET https://api.unusualwhales.com/api/option-trades/exchange-breakdown/{date}

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

date Market Date required

A trading date in the format of YYYY-MM-DD.

Example: 2024-01-18

Query Parameters

ticker[] array[string] optional

One or more underlying symbols to aggregate, e.g. `ticker[]=AAPL&ticker[]=NVDA`. Omit for whole-universe mode (top names by volume).

by_trade_code boolean optional

Whether to additionally group each row by the upstream trade condition code.

min_premium string optional

Only include individual prints whose premium (price × size × 100) is at least this value, before aggregating. Use to filter out smaller trades.

limit integer optional

Whole-universe mode only: tickers per page (ranked by volume). Default 100, max 500.

page integer optional

Whole-universe mode only: 1-based page of tickers. Default 1.

order string optional

Whole-universe mode only: how to rank tickers — `volume` (total contracts) or `premium` (total premium). Default `volume`.

Responses

200 422 500

Response Body 200 OK

call_trades integer

The number of call prints in this group.

Example: 3370

contracts integer

The total number of contracts traded in this group.

Example: 38633

exchange Exchange

The exchange the option trade was executed on.

Example: MXOP

premium number

The total premium of this group, computed as sum(price × size × 100).

Example: 5454330

put_trades integer

The number of put prints in this group.

Example: 3434

trade_code Upstream Condition Detail

The upstream condition detail/trade code of the option trade.

Example: auto

trade_count integer

The number of option prints in this group.

Example: 6804

underlying_symbol Option Contract Underlying Symbol

The underlying symbol of the contract.

Example: AAPL

Try It GET

API Token

Path Parameters

date required

Query Parameters

ticker[] array[string]

by_trade_code boolean

min_premium string

limit integer

page integer

order string

Request Sample

curl -X GET "https://api.unusualwhales.com/api/option-trades/exchange-breakdown/{date}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/option-trades/exchange-breakdown/{date}", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "call_trades": 3370,
      "contracts": 38633,
      "exchange": "AMXO",
      "premium": 5454330,
      "put_trades": 3434,
      "trade_code": "slan",
      "trade_count": 6804,
      "underlying_symbol": "AAPL"
    }
  ]
}