Get Order Book

Fetch a historical orderbook snapshot at any point in time.

GET /v1/orderbook

Get Order Book

cURL

curl --request GET \
  --url https://api.polydata.live/v1/orderbook \
  --header 'Authorization: <authorization>'

200

{
  "data.market": "<string>",
  "data.asset_id": "<string>",
  "data.timestamp": 123,
  "data.datetime": "<string>",
  "data.best_bid": 123,
  "data.best_ask": 123,
  "data.bids": [
    {}
  ],
  "data.asks": [
    {}
  ]
}

Returns the full L2 orderbook (bids + asks at all price levels) for an outcome token.

Authentication

Authorization · string · required

Bearer pd_live_xxxxx

Query Parameters

asset_id · string · required

Outcome token ID (Polymarket’s CLOB token ID).

timestamp · number

Unix timestamp in milliseconds. Returns the snapshot at or before this time. If omitted, returns the most recent available.

limit · number · default: "20"

Maximum number of price levels to return per side. Range: 1-100.

Response

data.market · string

Market condition ID

data.asset_id · string

Outcome token ID

data.timestamp · number

Snapshot timestamp (ms)

data.datetime · string

ISO datetime string

data.best_bid · number

Highest bid price

data.best_ask · number

Lowest ask price

data.bids · array

Array of {price, size}, sorted descending by price

data.asks · array

Array of {price, size}, sorted ascending by price

Example

curl

curl "https://api.polydata.live/v1/orderbook?asset_id=139156893172690782191684967390&timestamp=1776241000000&limit=10" \
  -H "Authorization: Bearer pd_live_xxxxx"

Sample response

{
  "success": true,
  "data": {
    "market": "0xa0f4c4924ea1a8b410b4ce821c2a9955fad21a1b19bdcfde90816732278b3dd5",
    "asset_id": "13915689317269078219168496739008737517740566192006337297676041270492637394586",
    "timestamp": 1776241000000,
    "datetime": "2026-04-15 08:16:40.000",
    "best_bid": 0.019,
    "best_ask": 0.020,
    "bids": [
      { "price": 0.019, "size": 145.5 },
      { "price": 0.018, "size": 200 }
    ],
    "asks": [
      { "price": 0.020, "size": 80 },
      { "price": 0.021, "size": 120 }
    ]
  }
}

Errors

Status	Error	Cause
401	invalid_api_key	Missing or wrong API key
403	data_access_denied	Your plan can’t access this timestamp
404	(no error code)	No snapshot available for this asset_id/timestamp