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

# TickerStockState

> OHLCV state of a stock for the current trading session. Open, close, high and low are scoped to the current market_time session: a new state starts when the session changes (premarket to regular to postmarket).

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

**Proto definition**

```protobuf schema.proto theme={null}
message TickerStockState {
  string ticker = 1;
  int64 total_volume = 2;
  int64 start_total_volume = 3;
  int64 volume = 4;
  double open = 5;
  double close = 6;
  double high = 7;
  double low = 8;
  int64 tape_time = 9;
  string date = 10;
  MarketTime market_time = 13;
}
```

## Fields

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

ticker
string
1

The stock symbol. Also the Kafka message key.

total\_volume
int64
2

Cumulative shares traded for the whole day so far, across all sessions.

start\_total\_volume
int64
3

Snapshot of total\_volume at the start of the current market\_time session. 0 during premarket.

volume
int64
4

Shares traded within the current market\_time session only (total\_volume - start\_total\_volume).

open
double
5

First trade price of the current session.

close
double
6

Most recent trade price of the current session.

high
double
7

Highest trade price of the current session.

low
double
8

Lowest trade price of the current session.

tape\_time
int64
9

Execution time of the latest trade in milliseconds since 1970 (unix).

date
string
10

The New York trading date in YYYY-MM-DD format.

market\_time
[MarketTime](/docs/kafka/types/MarketTime.md)
13

The trading session this state belongs to.