[
  {
    "snapshot_time": "2023-11-07T05:31:56Z",
    "exchange": "<string>",
    "market_id": "<string>",
    "token_id": "<string>",
    "outcome": "<string>",
    "bid_side": [
      123
    ],
    "ask_side": [
      123
    ],
    "original_last_update": "2023-11-07T05:31:56Z"
  }
]

Polymarket

Get Polymarket Orderbook

Retrieve historical orderbook snapshots for a Polymarket market. Each snapshot shows the full order depth at a point in time.

What you get

token_id: The token identifier for this orderbook side
outcome: The outcome label for this token (e.g., “Yes”, “No”, or a named outcome like “EDward Gaming”)
bid_side: Array of 1001 values representing buy order quantities at price levels from $0.000 to$ 1.000 in increments of $0.001 (0.1 cents). Index 0 =$ 0.000, index 1 = $0.001, ..., index 1000 =$ 1.000.
ask_side: Array of 1001 values representing sell order quantities at the same price levels.
Snapshot timestamps
Market identifier

Important This endpoint requires the `condition_id` (hex string starting with `0x`), NOT the standard `poly_id`. Get the condition_id from the market details endpoint first.

Use cases

Analyze historical liquidity
Build depth charts
Calculate spreads over time
Backtest trading strategies

Example

Request: GET /api/v1/poly/0x00000977017fa72fb6b1908ae694000d3b51f442c2552656b10bdbbfd16ff707/orderbook?limit=10
Header: X-API-Key: YOUR_API_KEY

GET

api

poly

{poly_id}

orderbook

[
  {
    "snapshot_time": "2023-11-07T05:31:56Z",
    "exchange": "<string>",
    "market_id": "<string>",
    "token_id": "<string>",
    "outcome": "<string>",
    "bid_side": [
      123
    ],
    "ask_side": [
      123
    ],
    "original_last_update": "2023-11-07T05:31:56Z"
  }
]

Authorizations

X-API-Key

string

header

required

Your API key (get one from the test-key endpoint above)

Path Parameters

poly_id

string

required

Polymarket condition ID (hex string). This is different from the standard poly_id - it's the long identifier starting with '0x' that uniquely identifies a market condition.

Query Parameters

limit

integer

default:10

Maximum number of snapshots to return (default: 10 in docs, no max limit)

Response

200 - application/json

Orderbook snapshots

snapshot_time

string<date-time>

exchange

string

market_id

string

token_id

string

Token identifier for this orderbook side

outcome

string

Outcome label for this token (e.g., Yes, No, or a named outcome)

bid_side

number[]

Array of 1001 values representing buy quantities at $0.000-$1.000 in $0.001 increments

ask_side

number[]

Array of 1001 values representing sell quantities at $0.000-$1.000 in $0.001 increments

original_last_update

string<date-time>

Get Polymarket Raw Orderbook Deltas Get Polymarket Trade History