Skip to main content
GET
/
api
/
v1
/
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>