Pro and Internal only. Upgrade to a WebSocket with your bearer key to receive the current prices for one event, or for up to 20 events in one league, every 15 seconds. Each message is a JSON object whose type is snapshot (the same body as the matching odds route, grouped by market unless group_by=bookmaker), heartbeat (nothing changed) or error (a problem object, after which the connection closes). A refresh counts towards your allowance like an ordinary odds request only when it sends a new snapshot; a heartbeat (nothing changed) is free. Every refresh still counts towards your per minute request limit. Up to two streams per key. A stream lasts at most one hour; reconnect for a fresh one. The stream is read only; a message from the client closes it. Close codes are 1000 (lifetime reached), 1008 (key, plan or limit change), 1009 (snapshot too large, narrow the filters), 1011 (refresh failed) and 1013 (client reading too slowly).
Request
- Base URL: https://api.sockodds.com/v1
- URL: https://api.sockodds.com/v1/stream/odds
- Auth: HTTP bearer
Query parameters
One event. Use this or league, not both.
Comma-separated market keys, at most 20.
Comma-separated bookmaker regions, at most 20.
Comma-separated bookmaker keys, at most 20.
How prices are grouped. market (the default) lists each market and outcome once, with every bookmaker's price under the outcome in prices, best price first. bookmaker lists each bookmaker with its own copy of the markets, the shape v1 launched with.
With league only. Events per snapshot, 1 to 20. Defaults to 10.
Response
Request failed
Changes
No recorded changes to this operation across all 1 revision of this API.