> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Stats Channel - Live Match Statistics Stream

> Stream realtime match statistics via WebSocket. Team and player stats — possession, shots, corners, cards, aces — in a canonical, sport-agnostic stat model.

## What it streams

In-game / post-game **statistics updates** for fixtures — team-level stats (corners, cards, shots, possession, …) and player-level stats (goals, assists, aces, kills, …), keyed by a sport-agnostic stat model.

***

## Routing

* Entity key: `payload.fixtureId`
* Filters: `sportIds`, `tournamentIds`, `fixtureIds`
* Access: live/pregame access is determined by your `apiKey`

***

## Payload structure

Stats travel as **resolved facts** in the canonical stat model. Team stat rows:

| Field | Type | Description |
| - | - | - |
| `fixtureId` | `string` | The fixture this stat applies to |
| `period` | `string` | The [period](https://docs.oddspapi.io/api-reference/enumerations.md#period) the stat is scoped to (`result`, `p1`, …) |
| `statType` | `string` | The stat (`score`, `corners`, `cards`, `aces`, …) — an [open taxonomy](https://docs.oddspapi.io/api-reference/enumerations.md#open-taxonomies-not-enums) |
| `participant1Value` | `number \| null` | Value for participant 1 |
| `participant2Value` | `number \| null` | Value for participant 2 |
| `updatedAt` | `string (ISO)` | When the resolved value last changed |

Player stat rows carry `playerId` and a single `value` instead of the participant pair:

| Field | Type | Description |
| - | - | - |
| `playerId` | `integer` | The player |
| `period` | `string` | Period scope |
| `statType` | `string` | The stat |
| `value` | `number \| null` | The player's value |
| `updatedAt` | `string (ISO)` | When the resolved value last changed |

***

## Semantics

* **Latest state.** Treat each update as the current resolved value for `(fixtureId, period, statType [, playerId])` — not a tick ledger.
* **Resolved, not raw.** Values are cross-source resolved facts (the same layer settlement reads), so counts only move forward during play and corrections arrive as explicit updates.
* The main scoreline also travels here as `statType = "score"` — but the dedicated [`scores`](https://docs.oddspapi.io/websocket/channels/scores) channel remains the recommended score feed.
* `statType` is an **open taxonomy**: which stats exist varies per sport; new stats appear as new values, never as schema changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.