Skip to main content
GET
/
historical
/
polymarket
/
top-of-book
Historical top of book
curl --request GET \
  --url https://api.oddpool.com/historical/polymarket/top-of-book

Documentation Index

Fetch the complete documentation index at: https://docs.oddpool.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
market_id
string
required
Polymarket condition ID (0x...).
​
asset_id
string
Filter by specific token ID. Omit to get both YES and NO tokens.
​
start_time
integer
Start time in Unix ms. Omit with end_time to get latest data.
​
end_time
integer
End time in Unix ms. Omit with start_time to get latest data.
​
granularity
string
default:"1m"
Snapshot interval: 1m or 5m.
​
limit
integer
default:"100"
Max rows per page (1-200).
​
pagination_key
string
Cursor from previous response for next page.

​
Example

curl -H "X-API-Key: oddpool_..." \
  "https://api.oddpool.com/historical/polymarket/top-of-book?market_id=0x36e8ca24...&asset_id=56914066...&start_time=1774015200000&end_time=1774018800000&granularity=5m"

​
Response

{
  "snapshots": [
    {
      "asset_id": "56914066788195652124...",
      "market_id": "0x00000977017fa72fb6b1...",
      "timestamp": 1774026026396,
      "best_bid": 0.987,
      "best_ask": 0.99,
      "mid": 0.9885,
      "spread": 0.003
    }
  ],
  "pagination": { ... }
}
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.