---
title: "Get Orderbooks"
method: GET
path: "/v2/polymarket/orderbooks"
tags: ["polymarket"]
---

# Get Orderbooks

`GET /v2/polymarket/orderbooks`

Fetch historical orderbook snapshots for a specific asset (token ID) over a specified time range.

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 January 1st, 2026.

## Query parameters

- `token_id` string, required — The token ID (asset) for the Polymarket market
- `start_time` integer, required — Start time in Unix timestamp (milliseconds)
- `end_time` integer, required — End time in Unix timestamp (milliseconds)
- `limit` integer — Maximum number of snapshots to return
- `pagination_key` string, nullable — Pagination key to get the next chunk of data

## Response `200`

Successful Response

- OrderbooksResponse — Orderbooks endpoint response.
  - `snapshots` OrderbookSnapshot[], required
    - `asks` OrderbookLevel[], required — Ask price levels, ordered by price
      - `size` number, required — Size at this price level
      - `price` number, required — Price level (0-1 range)
    - `bids` OrderbookLevel[], required — Bid price levels, ordered by price
      - `size` number, required — Size at this price level
      - `price` number, required — Price level (0-1 range)
    - `hash` string, required — Orderbook state hash
    - `assetId` string, required — Asset/token ID
    - `timestamp` integer, required — Snapshot timestamp (Unix epoch MILLISECONDS)
    - `tickSize` string, required — Tick size for price levels
    - `indexedAt` integer, required — When snapshot was indexed (Unix epoch MILLISECONDS)
    - `market` string, required — Market condition ID / address
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)