v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Orderbook History

Fetches historical orderbook snapshots for a specific asset (token ID) over a specified time range. If no start_time and end_time are provided, returns the latest orderbook snapshot for the market. Returns snapshots of the order book including bids, asks, and market metadata in order. All timestamps are in milliseconds. Orderbook data has history starting from October 14th, 2025. Note: When fetching the latest orderbook (without start/end times), the limit and pagination_key parameters are ignored.

get/polymarket/orderbooks

Query parameters

token_idstring required

Example:56369772478534954338683665819559528414197495274302917800610633957542171787417

The token id (asset) for the Polymarket market

start_timeinteger

Example:1760470000000

Start time in Unix timestamp (milliseconds). Optional - if not provided along with end_time, returns the latest orderbook snapshot.

end_timeinteger

Example:1760480000000

End time in Unix timestamp (milliseconds). Optional - if not provided along with start_time, returns the latest orderbook snapshot.

limitinteger

Example:100

Maximum number of snapshots to return (default: 100, max: 200). Ignored when fetching the latest orderbook without start_time and end_time.

pagination_keystring

Example:eyJhc3NldElkIjoiMTM1ODUxMjc2NDY0NTMxMDM0ODcyMjY1MTg3ODYyNjk5NjE0MDAyMjI5NzA0NzI3MzgxMTIwOTU1NDY0MDc5MTY4NDcxMTIyNzE2NjQiLCJ0aW1lc3RhbXAiOjE3NjExMDQwOTg5MTR9

Pagination key to get the next chunk of data. Ignored when fetching the latest orderbook without start_time and end_time.

Response

Orderbook history response

Example response

{
  "snapshots": [
    {
      "asks": [
        {
          "size": "5000013.15",
          "price": "0.999"
        }
      ],
      "bids": [
        {
          "size": "438389.53",
          "price": "0.001"
        }
      ],
      "hash": "85c493ebeea97e2f70c85a1469aede05f892408f",
      "minOrderSize": "5",
      "negRisk": true,
      "assetId": "56369772478534954338683665819559528414197495274302917800610633957542171787417",
      "timestamp": 1760471849407,
      "tickSize": "0.001",
      "indexedAt": 1760471852863,
      "market": "0xd10bc768ede58b53ed400594240b0a0603134a32dab89ec823a18759cbc180ca"
    }
  ],
  "pagination": {
    "limit": 100,
    "count": 4,
    "pagination_key": "eyJhc3NldElkIjoiMTM1ODUxMjc2NDY0NTMxMDM0ODcyMjY1MTg3ODYyNjk5NjE0MDAyMjI5NzA0NzI3MzgxMTIwOTU1NDY0MDc5MTY4NDcxMTIyNzE2NjQiLCJ0aW1lc3RhbXAiOjE3NjExMDQwOTg5MTR9"
  }
}