Skip to main content
GET
Polymarket historical orderbook
Full orderbook snapshots with bids, asks, and derived best bid/ask per token. Polymarket markets have two tokens (YES and NO) per condition; each snapshot row is for a single token. Use asset_id to filter to one token, or omit it to return both.

Request

Query parameters

market_id
string
required
Polymarket condition ID (0x...). Also accepts the numeric source_market_id.
asset_id
string
CLOB token ID. Omit to return both YES and NO tokens.
start_time
string
Range start in Unix milliseconds. Must be set with end_time.
end_time
string
Range end in Unix milliseconds.
granularity
string
default:"1m"
Bucket size for range queries: 1m or 5m.
limit
integer
default:"100"
Max rows per page (1–200).
pagination_key
string
Cursor from the previous response.

Examples

Latest snapshots