Filtered SSE stream that emits only when a tracked price moves by at least `threshold` American-odds cents (default 5). Designed for steam-detection bots and CLV trackers that do not want a full odds feed. Each emitted event carries the before and after prices plus the wall-clock delta.
Query params: apiKey, threshold (int, default 5), bookmakers (CSV), markets (CSV), heartbeat_s (default 10), si
Receive only `odds_drop` frames where the change exceeds the configured threshold. Heavy filter on the server side; bandwidth is a tiny fraction of the full /sse/odds stream. Coverage diagnostics arri
Messages
connected
Sent once immediately after upgrade. Confirms auth, tier, push mode, and any active query-param filters.
Content-Type:
odds_drop
Emitted only on the /v1/odds-drop/{sport_key} channel. Fires when a tracked price moves by at least the configured threshold (default 5 American-odds cents). Payload carries both the prior and the new
Content-Type:
heartbeat
Sent on idle channel timeout (default 30 s for WS, configurable 1-30 s for SSE via `heartbeat_s`). Carries server timestamp; clients should treat absence of any frame for 2x heartbeat as a disconnect
Content-Type:
stream_status
Reports unresolved Pinnacle fixture families once per subscription generation. It contains no odds. Valid families continue; a fresh current snapshot is required to clear the incomplete-coverage warni
Content-Type:
About AsyncAPI
The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.