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

# StockPriceLevelVolume

> A stock activity update for one ticker and price level, split between lit and off lit trades. 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**8**
topic[stock-price-level-volume](https://api.unusualwhales.com/docs/kafka/topics/stock-price-level-volume.md)

**Proto definition**

```protobuf schema.proto theme={null}
message StockPriceLevelVolume {
  string ticker = 1;
  string date = 2;
  int64 tape_time = 3;
  int64 dark_pool_volume = 4;
  int64 regular_volume = 5;
  double price = 6;
  int32 dark_pool_trades = 7;
  int32 regular_trades = 8;
}
```

## Fields

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

ticker
string
1

The stock ticker. Also the Kafka message key.

date
string
2

The trading date in YYYY-MM-DD format.

tape\_time
int64
3

Execution time of the latest trade in the incremental update in Unix epoch milliseconds.

dark\_pool\_volume
int64
4

Shares traded off lit at this price level in the incremental update.

regular\_volume
int64
5

Shares traded on lit venues at this price level in the incremental update.

price
double
6

The stock price level represented by this incremental update.

dark\_pool\_trades
int32
7

Number of off lit trades at this price level in the incremental update.

regular\_trades
int32
8

Number of lit trades at this price level in the incremental update.