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.
Discovery needs no key. Ratings and market analysis are Pro.
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.