Polymarket API endpoint
Returns the order book for one Polymarket outcome token, identified by the required `token_id`. The `book` has `bids` and `asks` as price and size pairs, the last trade price, tick size, minimum order size, condition id and a timestamp. Prices and sizes are numbers.
/polymarket/token/{token_id}/orderbookPath parameters:
token_id: required Polymarket CLOB token id.Notable response behavior:
| Field | Filled in, of 113 checked | Values in the sample |
|---|---|---|
| price | 113 | 0.03 to 1, median 0.25 |
| size | 113 | 5.15 to 505,857.15, median 1,999.99 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| token_id (path) | string | Yes | Polymarket CLOB token id | 81927025054404355287140018940169293739219157042658469116956164881873598220211 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/polymarket/token/81927025054404355287140018940169293739219157042658469116956164881873598220211/orderbook" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
"book": {
"condition_id": "0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327",
"token_id": "81927025054404355287140018940169293739219157042658469116956164881873598220211",
"bids": [
{
"price": 0.03,
"size": 5
}
],
"asks": [
{
"price": 0.55,
"size": 500
}
],
"min_order_size": 5,
"tick_size": 0.01
}
}
}Request schema
No body schema
Response schema
#/definitions/polymarket.tokenOrderBookResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | polymarket.TokenOrderBookResponse | No | ||||
| data.book | object | No | Order book for the token with its bids and asks. | |||
| data.book.asks | array | No | Ask levels in the order book, one item per price level. | |||
| data.book.asks[].price | number | No | 0.03 | Price of this order book level. | ||
| data.book.asks[].size | number | No | 5 | Total size of the orders resting at this price. | ||
| data.book.bids | array | No | Bid levels in the order book, one item per price level. | |||
| data.book.bids[].price | number | No | 0.03 | Price of this order book level. | ||
| data.book.bids[].size | number | No | 5 | Total size of the orders resting at this price. | ||
| data.book.condition_id | string | No | 0x1a987cd4e88488fd12905fa9ae82cef381e03f4af68289275c4c0c2613db9327 | Condition id of the market the token belongs to. | ||
| data.book.hash | string | No | 31facd52b62495bbc142facb81275400d978f6bf | Hash of the order book snapshot. | ||
| data.book.last_trade_price | number | No | 0.285 | Price of the most recent trade on the token. | ||
| data.book.min_order_size | number | No | 5 | Smallest order size the market accepts. | ||
| data.book.neg_risk | boolean | No | `true` when the market is part of a negative-risk group of linked outcomes. | |||
| data.book.tick_size | number | No | 0.01 | Smallest price increment the market accepts. | ||
| data.book.timestamp | string | No | 1780837460175 | Time of the order book snapshot, in Unix milliseconds. | ||
| data.book.token_id | string | No | 81927025054404355287140018940169293739219157042658469116956164881873598220211 | Token id of the outcome the order book belongs to. | ||
| data.fetched_at | string | No | 2026-06-07T11:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.source_url | string | No | https://clob.polymarket.com/book?token_id=81927025054404355287140018940169293739219157042658469116956164881873598220211 | URL the data was read from. | ||
| data.token_id | string | No | 81927025054404355287140018940169293739219157042658469116956164881873598220211 | Token id of the outcome that was requested. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/polymarket/token/81927025054404355287140018940169293739219157042658469116956164881873598220211/orderbook" \
-H "x-api-key: $CRAWLORA_API_KEY"