Historical top of book
Polymarket
Historical top of book
Lightweight timeseries of best bid, best ask, mid, and spread per token.
GET
Historical top of book
Lightweight timeseries of best bid, best ask, mid, and spread per token. Same data as the orderbook endpoint but without the full level arrays.
Polymarket markets have two tokens (YES and NO) per condition. Use
asset_id to filter to a specific token.Parameters
string
required
Polymarket condition ID (
0x...).string
Filter by specific token ID. Omit to get both YES and NO tokens.
integer
Start time in Unix ms. Omit with
end_time to get latest data.integer
End time in Unix ms. Omit with
start_time to get latest data.string
default:"1m"
Snapshot interval:
1m or 5m.integer
default:"100"
Max rows per page (1-200).
string
Cursor from previous response for next page.
Example
Response
best_bid and best_ask are null when the book had no resting orders at sample time. Filter client-side if you only want quoted snapshots.