Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oddpool.com/llms.txt

Use this file to discover all available pages before exploring further.

Available on all plans (Free tier included).
Historical orderbook snapshots, top-of-book timeseries, and trade data for Polymarket markets. Data available from March 20, 2026 onward. Returns native Polymarket data with asset IDs, bids/asks, and condition IDs. Data becomes available approximately one hour after it occurs.
Polymarket markets have two tokens (YES and NO) per condition. Each snapshot row is for a single token. Use the asset_id parameter to filter to a specific token, or omit it to get both.

​
What you can build

  • Backtesting: replay historical orderbooks and trades to validate trading strategies before deploying capital
  • Price charts: build custom candlestick or mid-price charts from top-of-book snapshots
  • Liquidity analysis: measure how bid/ask depth and spreads change around major events like elections or economic releases
  • Execution quality: compare your historical fills against the orderbook at time of execution to measure slippage
  • On-chain trade analysis: correlate trade flow with on-chain activity using transaction_hash and fee_rate_bps fields
  • Market making research: study spread dynamics and depth profiles to calibrate quoting strategies

​
Pagination

All historical endpoints use cursor-based pagination. Pass pagination_key from the previous response to get the next page. 
{
  "pagination": {
    "limit": 100,
    "count": 100,
    "has_more": true,
    "pagination_key": "eyJo..."
  }
}