Skip to main content

​
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.