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

# ticker-oi-stats

> Compacted current and previous daily open interest and historical option activity statistics per ticker

Topic
messages**1**
routing**message key**
encoding**protobuf**

## Messages on this topic

[ticker
TickerOiStats
Current and previous open interest statistics for a ticker after OI processing completes.
4 fields→](/docs/kafka/types/TickerOiStats.md)

The message type is determined by the Kafka message key.

## Consume the topic

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

# The record key selects the message type.
BY_KEY = {
    b"ticker": TickerOiStats,
}

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

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

    message_type = BY_KEY.get(msg.key())
    if message_type is None:
        continue

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