Documentation Index
Fetch the complete documentation index at: https://docs.polyhistorical.com/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get up and running with PolyHistorical in three steps.
Step 1: Get your API key
Sign up and create an API key from your dashboard.
Step 2: List active markets
Fetch the latest active BTC prediction markets:
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.polyhistorical.com/v1/markets?coin=BTC&resolved=false&limit=5"
Step 3: Get snapshots for a market
Pick a market slug from the previous response and fetch its snapshots:
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.polyhistorical.com/v1/markets/btc-updown-5m-1774581000/snapshots?coin=BTC&limit=10"
Example response
{
"market": {
"slug": "btc-updown-5m-1774581000",
"market_id": "1724470",
"event_id": "308810",
"market_type": "5m",
"start_time": "2026-03-27T03:10:00Z",
"end_time": "2026-03-27T03:15:00Z",
"btc_price_start": 87234.50,
"btc_price_end": null,
"condition_id": "0xabc123",
"clob_token_up": "71321",
"clob_token_down": "71322",
"winner": null,
"final_volume": null,
"final_liquidity": null,
"resolved_at": null,
"created_at": "2026-03-27T03:09:00Z",
"updated_at": "2026-03-27T03:10:05Z"
},
"snapshots": [
{
"time": "2026-03-27T03:10:05Z",
"btc_price": 87234.50,
"price_up": 0.52,
"price_down": 0.48,
"orderbook_up": {
"bids": [{"price": "0.51", "size": "1500"}],
"asks": [{"price": "0.53", "size": "1200"}]
}
}
],
"total": 1,
"limit": 10,
"offset": 0
}
What’s next?
API Reference
Explore all available endpoints, parameters, and response formats.
Rate Limits
Understand request limits and how to handle 429 responses.
