Live Games
WS·live_games·Dev Tier+Price, trade, and score updates scoped to active live games. Subscribe using event_ids.
Overview
Use case: Keep a live-game dashboard current as market activity arrives.
Requirements
- Available with a Dev, Pro, or Enterprise API key.
- Use event IDs in the active live-game set. An events search result alone does not establish live-game eligibility.
- UNKNOWN_EVENT_ID identifies skipped event IDs. A subscription acknowledgement does not guarantee immediate data delivery.
- There is no standalone trades channel. Use GET /api/v2/trades for the general trade feed.
Send
| Field | Type | Required | Notes |
|---|---|---|---|
| action | string | yes | Must be "subscribe" for this section. |
| channel | string | yes | Must be "live_games". |
| market_ids | string[] | unsupported | Ignored / not used by this channel. |
| group_ids | number[] | unsupported | Ignored / not used by this channel. |
| event_ids | number[] | yes | Event IDs in the active live-game set. Unknown IDs produce UNKNOWN_EVENT_ID. |
| wildcard | behavior | not available | At least one supported id list should be provided. |
Receive
Data messages use the standard envelope: channel, type, ts, data. Types for this channel include: price, trade, score.
Data fields (inside data)
| Field | Type | Description |
|---|---|---|
| type | string | price, trade, or score. |
| event_id | integer | Subscribed event ID. |
| price | object | Present on price messages. Quote fields are in cents (0-100). |
| trade | object | Present on trade messages. price is a fraction (0-1); price, size, and notional may be numbers or numeric strings. |
| score | object or null | Present on score messages. home and away may be absent or null. |
| ts | number | Optional inner timestamp. The outer envelope includes a timestamp in Unix seconds. |