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. 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.

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 11, 2026