Skip to main content
GET
Get an orderbook snapshot
GET /orderbook-v3/snapshot returns the aggregated book for a single market.
Prefer the realtime orderbook_v3:{marketHash} channel over polling this endpoint. Use the snapshot once to bootstrap state, then apply stream publications.
Use showTakerPerspective for display only. percentageOdds is from the perspective of the maker. Read the order book walks the conversion through.

Query Parameters

marketHash
string
required

The market hash for which to get the snapshot. For many markets in one call use GET /orders-v3/odds/best, which takes up to 100 hashes but returns only the top level per side.

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

Same flat shape as the realtime orderbook channel payload: level arrays beside marketHash and version.

Last modified on August 11, 2026