Skip to main content
GET
Get best odds
GET /orders-v3/odds/best returns the best level on each side for a set of markets. It requires an API key. For every level on a single market, use GET /orderbook-v3/snapshot — both read the top of the same book.
Prefer the realtime best_odds_v3:global channel over polling this endpoint. Use this route once to seed state, then apply stream publications.
Exactly one of marketHashes or leagueIds must be provided, but not both.

Authorizations

x-sx-api-key
string
header
required

API key, sent as the x-sx-api-key header. Generate one from the API keys section of your account page on sx.bet.

Query Parameters

marketHashes
string

Comma-separated, maximum 100. Required unless leagueIds is given.

leagueIds
string

Comma-separated integer league ids, maximum 5. Required unless marketHashes is given.

showTakerPerspective
boolean

Return the book from the perspective of someone wanting each outcome, instead of the makers' own: each side's odds are inverted, the sides are swapped, and each size is restated as the taker stake that fully consumes that level. Accepts true/false/1/0, case-insensitively — TRUE and True work. yes, on and an empty value are a 400.

Response

status
string

success or failure if the request succeeded or not

data
object
Last modified on August 21, 2026