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

# option-states

> The live state of option chains. Contains open interest updates as well as volumes

Topic
messages**1**
routing**single type**
encoding**protobuf**

## Messages on this topic

[all messages
OptionState
Daily stats for Option contracts for the given date. Contracts are being pushed any time there is a volume or open interest update is available.
49 fields→](/docs/kafka/types/OptionState.md)

All messages on this topic are of a single type.

## Consume the topic

```python Python theme={null}
from confluent_kafka import Consumer
from unusualwhales.schema_pb2 import OptionState

# CONFIG comes from the Connecting section of the Kafka overview.
consumer = Consumer(CONFIG | {"group.id": "my-option-states-consumer"})
consumer.subscribe(["option-states"])

while True:
    msg = consumer.poll(1.0)
    if msg is None or msg.error():
        continue

    event = OptionState()
    event.ParseFromString(msg.value())
    print(event)
```