---
title: "Get Orderbook History"
method: GET
path: "/polymarket/orderbooks"
---

# Get Orderbook History

`GET /polymarket/orderbooks`

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.

## Query parameters

- `token_id` string, required
- `start_time` integer
- `end_time` integer
- `limit` integer
- `pagination_key` string

## Response `200`

Orderbook history response

- object
  - `snapshots` object[] — Array of orderbook snapshots at different points in time
    - `asks` object[] — Sell orders, ordered by price
      - `size` string
      - `price` string
    - `bids` object[] — Buy orders, ordered by price
      - `size` string
      - `price` string
    - `hash` string
    - `minOrderSize` string
    - `negRisk` boolean
    - `assetId` string
    - `timestamp` integer — Timestamp of the snapshot in milliseconds
    - `tickSize` string
    - `indexedAt` integer — When the snapshot was indexed in milliseconds
    - `market` string
  - `pagination` object
    - `limit` integer
    - `count` integer — Number of snapshots returned
    - `pagination_key` string — The pagination key to pass in to get the next chunk of data
    - `has_more` boolean — Whether there are more snapshots available

## Other responses

- `400` — Bad Request - Invalid parameters

---

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