> ## 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

# OptionStockPriceLevel

> An option activity update grouped by underlying ticker and stock price level. Updates are published as INCREMENTAL updates for the time window they computed. If you store the data in a database you should be adding the values to the existing values in the database.

Message
fields**11**
topic[ticker-levels](/docs/kafka/topics/ticker-levels.md)

**Proto definition**

```protobuf schema.proto theme={null}
message OptionStockPriceLevel {
  string ticker = 1;
  int32 call_volume = 2;
  int32 put_volume = 3;
  int32 call_bid_side_volume = 4;
  int32 call_ask_side_volume = 5;
  int32 put_bid_side_volume = 6;
  int32 put_ask_side_volume = 7;
  int32 call_trades = 8;
  int32 put_trades = 9;
  string date = 10;
  double price = 11;
}
```

## Fields

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

ticker
string
1

The underlying ticker.

call\_volume
int32
2

Call contracts traded in the incremental update.

put\_volume
int32
3

Put contracts traded in the incremental update.

call\_bid\_side\_volume
int32
4

Call contracts executed on the bid side in the incremental update.

call\_ask\_side\_volume
int32
5

Call contracts executed on the ask side in the incremental update.

put\_bid\_side\_volume
int32
6

Put contracts executed on the bid side in the incremental update.

put\_ask\_side\_volume
int32
7

Put contracts executed on the ask side in the incremental update.

call\_trades
int32
8

Number of call trades in the incremental update.

put\_trades
int32
9

Number of put trades in the incremental update.

date
string
10

The trading date in YYYY-MM-DD format.

price
double
11

The underlying stock price level represented by this incremental update.
