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

# predictions-positions

> Full states of prediction market outcome token positions for a given wallet/user whenever they change on chain

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

## Messages on this topic

[all messages
PredictionsPosition
Snapshot of a user's position in a single outcome token, published to the `predictions-positions` Kafka topic every time the position changes on-chain. Each message carries the full new state of the position, not a delta. Prices and USD amounts are denominated in USDC; token amounts are in outcome tokens (shares), where one winning share redeems for \$1.
15 fields→](/docs/kafka/types/PredictionsPosition)

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 PredictionsPosition

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

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

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