Skip to main content
GET
/
v1
/
polymarket
/
orderbooks
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/orderbooks?token_id=21742633...&start_time=1704067200000&end_time=1704153600000&limit=50"
{
  "snapshots": [
    {
      "assetId": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
      "market": "0x1a2b3c4d...",
      "timestamp": 1704067200000,
      "indexedAt": 1704067201234,
      "hash": "abc123...",
      "tickSize": "0.01",
      "bids": [
        {"price": "0.55", "size": "10000"},
        {"price": "0.54", "size": "25000"},
        {"price": "0.53", "size": "50000"}
      ],
      "asks": [
        {"price": "0.56", "size": "8000"},
        {"price": "0.57", "size": "20000"},
        {"price": "0.58", "size": "35000"}
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "count": 50,
    "pagination_key": "eyJhc3NldElkIjoiMjE3NDI2MzMuLi4iLCJ0aW1lc3RhbXAiOjE3MDQwNjcyMDAwMDB9",
    "has_more": true
  }
}

Overview

Fetch historical orderbook snapshots for a specific token. Returns bids and asks at each point in time, useful for analyzing market depth and liquidity.
Orderbook data history starts from January 1st, 2026. Earlier data is not available.
token_id
string
required
The token ID (asset) for the Polymarket market
start_time
integer
required
Start time in Unix timestamp (milliseconds)
end_time
integer
required
End time in Unix timestamp (milliseconds)
limit
integer
default:"100"
Maximum number of snapshots to return (1-200)
pagination_key
string
Pagination key for fetching the next page of results
snapshots
array
pagination
object
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/orderbooks?token_id=21742633...&start_time=1704067200000&end_time=1704153600000&limit=50"
{
  "snapshots": [
    {
      "assetId": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
      "market": "0x1a2b3c4d...",
      "timestamp": 1704067200000,
      "indexedAt": 1704067201234,
      "hash": "abc123...",
      "tickSize": "0.01",
      "bids": [
        {"price": "0.55", "size": "10000"},
        {"price": "0.54", "size": "25000"},
        {"price": "0.53", "size": "50000"}
      ],
      "asks": [
        {"price": "0.56", "size": "8000"},
        {"price": "0.57", "size": "20000"},
        {"price": "0.58", "size": "35000"}
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "count": 50,
    "pagination_key": "eyJhc3NldElkIjoiMjE3NDI2MzMuLi4iLCJ0aW1lc3RhbXAiOjE3MDQwNjcyMDAwMDB9",
    "has_more": true
  }
}
Timestamps are in milliseconds for this endpoint, unlike other endpoints that use seconds.

Use Cases

Liquidity Analysis

Analyze market depth and liquidity over time

Spread Tracking

Monitor bid-ask spreads historically

Market Making

Backtest market making strategies

Slippage Estimation

Estimate execution slippage for large orders

Authorizations

x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Query Parameters

token_id
string
required

The token ID (asset) for the Polymarket market

start_time
integer
required

Start time in Unix timestamp (milliseconds)

end_time
integer
required

End time in Unix timestamp (milliseconds)

limit
integer
default:100

Maximum number of snapshots to return

Required range: 1 <= x <= 200
pagination_key
string | null

Pagination key to get the next chunk of data

Response

Successful Response

Orderbooks endpoint response.

snapshots
OrderbookSnapshot · object[]
required
pagination
CursorPagination · object
required

Cursor-based pagination for endpoints that don't support offset.