> ## Documentation Index
> Fetch the complete documentation index at: https://api.unusualwhales.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> API requests use the base URL https://api.unusualwhales.com and require a bearer token in the `Authorization` header (`Authorization: Bearer <API_KEY>`). Create and manage API tokens at https://unusualwhales.com/dashboard/api.
> For live market data inside an AI tool, use the Unusual Whales MCP server at https://unusualwhales.com/public-api/mcp.
> Instructions for agents using Unusual Whales tools: https://unusualwhales.com/skill.md

# OptionTrade

> A single executed option trade with its NBBO, greeks, volume breakdown and underlying metadata at the time of the trade.

Message
fields**47**
topic[all-option-trades](/docs/kafka/topics/all-option-trades.md)

**Proto definition**

```protobuf schema.proto theme={null}
message OptionTrade {
  string id = 1;
  string underlying_symbol = 2;
  int64 executed_at = 3;
  string nbbo_bid = 4;
  string nbbo_ask = 5;
  int32 size = 6;
  string price = 7;
  string option_chain_id = 8;
  string alert_score = 9;
  int64 created_at = 10;
  repeated string report_flags = 11;
  repeated string tags = 12;
  string expiry = 13;
  string option_type = 14;
  int32 open_interest = 15;
  string strike = 16;
  string premium = 17;
  int64 volume = 19;
  string underlying_price = 20;
  string ewma_nbbo_ask = 21;
  string ewma_nbbo_bid = 22;
  string implied_volatility = 23;
  string delta = 24;
  string theta = 25;
  string gamma = 26;
  string vega = 27;
  string rho = 28;
  string theo = 29;
  string upstream_cond_details = 30;
  int32 market_center_locate = 31;
  string exchange = 32;
  int64 ask_vol = 33;
  int64 bid_vol = 34;
  int64 no_side_vol = 35;
  int64 mid_vol = 36;
  int64 multi_vol = 37;
  int64 stock_multi_vol = 38;
  int32 option_symbol_id = 39;
  int32 ticker_id = 40;
  int32 root_ticker_id = 41;
  optional TickerInfo ticker_info = 42;
  optional OptionExchange execution_exchange = 43;
  optional OptionExchange nbbo_bid_exchange = 44;
  optional OptionExchange nbbo_ask_exchange = 45;
  optional OptionContractQuote nbbo_bid_quote = 46;
  optional OptionContractQuote nbbo_ask_quote = 47;
  TradingHours trading_hours = 48;
}
```

## Fields

The number on the right of each row is the protobuf field number.

id
string
1

Unique UUID of the trade.

underlying\_symbol
string
2

The underlying ticker symbol.

executed\_at
int64
3

The time at which the trade executed in milliseconds since 1970 (unix)

nbbo\_bid
string
4

The NBBO bid at the time of the trade.

nbbo\_ask
string
5

The NBBO ask at the time of the trade.

size
int32
6

The size of the trade in number of contracts.

price
string
7

The price at which the trade executed.

option\_chain\_id
string
8

OptionSymbol in the OSI format, SPY241227C00480000

alert\_score
string
9

Deprecated, don't use

created\_at
int64
10

The time the trade record was created in milliseconds since 1970 (unix)

report\_flags
string
repeated
11

Trade report flags from the upstream feed.

tags
string
repeated
12

Classification tags assigned to the trade.

expiry
string
13

The expiration date of the option contract.

option\_type
string
14

The option type, call or put.

open\_interest
int32
15

The OI of the chain

strike
string
16

The strike price of the option contract.

premium
string
17

The premium of the trade (size \* price \* contract multiplier).

volume
int64
19

The total market volume of the option symbol at the time of the trade.

underlying\_price
string
20

The price of the underlying at the time of the trade.

ewma\_nbbo\_ask
string
21

The EWMA smoothed NBBO ask.

ewma\_nbbo\_bid
string
22

The EWMA smoothed NBBO bid.

implied\_volatility
string
23

The implied volatility of the option.

delta
string
24

The delta of the option.

theta
string
25

The theta of the option.

gamma
string
26

The gamma of the option.

vega
string
27

The vega of the option.

rho
string
28

The rho of the option.

theo
string
29

The theoretical price of the option.

upstream\_cond\_details
string
30

The upstream trade code of the transaction.

market\_center\_locate
int32
31

Deprecated, dont use

exchange
string
32

The exchange on which the trade executed.

ask\_vol
int64
33

The total ask side volume of the option symbol at the time of the trade.

bid\_vol
int64
34

The total bid side volume of the option symbol at the time of the trade.

no\_side\_vol
int64
35

The total no side volume of the option symbol at the time of the trade.

mid\_vol
int64
36

The total mid volume of the option symbol at the time of the trade.

multi\_vol
int64
37

The total multi leg volume of the option symbol at the time of the trade.

stock\_multi\_vol
int64
38

The total stock multi leg volume of the option symbol at the time of the trade.

option\_symbol\_id
int32
39

Internal unique ID for the option contract.

ticker\_id
int32
40

Internal unique ID for the given ticker.

root\_ticker\_id
int32
41

Internal unique ID for the root ticker (indices).

ticker\_info
[TickerInfo](/docs/kafka/types/TickerInfo.md)
optional
42

Information about the ticker such as sector, industry, next earnings date and more.

execution\_exchange
[OptionExchange](/docs/kafka/types/OptionExchange.md)
optional
43

The exchange on which the trade executed.

nbbo\_bid\_exchange
[OptionExchange](/docs/kafka/types/OptionExchange.md)
optional
44

The exchange publishing the NBBO bid at the time of the trade.

nbbo\_ask\_exchange
[OptionExchange](/docs/kafka/types/OptionExchange.md)
optional
45

The exchange publishing the NBBO ask at the time of the trade.

nbbo\_bid\_quote
[OptionContractQuote](/docs/kafka/types/OptionContractQuote.md)
optional
46

The NBBO bid at the time of the trade.

nbbo\_ask\_quote
[OptionContractQuote](/docs/kafka/types/OptionContractQuote.md)
optional
47

The NBBO ask at the time of the trade.

trading\_hours
[TradingHours](/docs/kafka/types/TradingHours.md)
48

Trading session (GTH/RTH/Curb).