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

# TradingState

> A trading halt, pause or resumption for a stock.

Message
fields**8**
topic[trading-halts](/docs/kafka/topics/trading-halts.md)

**Proto definition**

```protobuf schema.proto theme={null}
message TradingState {
  string ticker = 1;
  string state = 2;
  string reason = 3;
  int64 time = 4;
  string sector = 5;
  string marketcap = 6;
  string avg_vol_30 = 7;
  int64 curr_vol = 8;
}
```

## Fields

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

ticker
string
1

The symbol of the halted or resumed stock.

state
string
2

The trading state: halt, pause, quote\_only\_period or trading.

reason
string
3

Halt or resume reason, e.g. "Volatility Trading Pause" or "Halt News Pending". Empty when no reason was given.

time
int64
4

The time of the state change in milliseconds since 1970 (unix).

sector
string
5

Currently not populated.

marketcap
string
6

Currently not populated.

avg\_vol\_30
string
7

Currently not populated.

curr\_vol
int64
8

Currently not populated.