Skip to main content
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.