Skip to main content
GET
Get an orderbook snapshot
GET /orderbook-v3/snapshot/market returns the aggregated book for a single market, the same book as the public snapshot. It requires an API key.
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.

Authorizations

x-sx-api-key
string
header
required

API key, sent as the x-sx-api-key header.

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 October 13, 2026