History
Get token order book history
Get historical order book snapshots for a specific token.
Pagination limits:
- Default limit: 100 points per page
- Maximum limit: 200 points per page
- Use cursor from metadata.next_cursor to fetch the next page
Aggregation: The last (most recent) order book in each interval is returned.
Format: JSON only.
get/v1/tokens/{token_id}/books
Request
- Base URL: https://api.polymarketdata.co
- URL: https://api.polymarketdata.co/v1/tokens/{token_id}/books
- Auth: API key in header X-API-Key
Path parameters
token_idstring required
Token ID.
Example:12345
Query parameters
start_tsstring required
Inclusive range start. Accepts ISO 8601 timestamp or Unix seconds.
Example:2025-09-04T00:00:00Z
end_tsstring required
Exclusive range end. Accepts ISO 8601 timestamp or Unix seconds.
Example:2025-09-05T00:00:00Z
resolution'1m' | '10m' | '1h' | '6h' | '1d' required
Supported time resolutions for historical endpoints.
Aggregation bucket size.
limitinteger
Maximum number of points to return in this page. Default: 100, max: 200.
Example:100
cursorstring nullable
Opaque cursor from a previous response metadata.next_cursor.
Response
Historical order book snapshots for a single token.
Example response
{
"data": [
{
"asks": [
[
0.73,
140
],
[
0.74,
300
]
],
"bids": [
[
0.72,
150
],
[
0.71,
320
]
],
"t": "2025-09-05T10:00:00Z"
}
],
"market_id": "618831",
"metadata": {
"count": 1,
"limit": 100
},
"resolution": "1h",
"token_id": "12345",
"token_label": "Yes"
}Changes
No recorded changes to this operation across all 1 revision of this API.