Skip to main content
GET
/
v1
/
markets
/
{slug}
/
snapshots
Get Snapshots
curl --request GET \
  --url https://api.polyhistorical.com/v1/markets/{slug}/snapshots
{
  "market": {},
  "snapshots": [
    {}
  ],
  "total": 123
}

​
Get Snapshots

Returns the market details along with its time-series snapshots, including price data and optional order book depth.

​
Request

GET https://api.polyhistorical.com/v1/markets/{slug}/snapshots

​
Path parameters

​
slug
string
required
The market slug, e.g. btc-updown-5m-1774581000

​
Query parameters

​
coin
string
required
Cryptocurrency to query. Supported: BTC, ETH, SOL
​
limit
integer
default:"100"
Number of snapshots to return (1-100)
​
offset
integer
default:"0"
Pagination offset
​
include_orderbook
boolean
default:"false"
Include full order book data (bids and asks) in each snapshot. Set to false for lower latency.

​
Response

​
market
object
The market object (same as Get Market)
​
snapshots
array
Array of snapshot objects, each containing:
  • time (string) — Snapshot timestamp (ISO 8601)
  • btc_price (number) — BTC price at snapshot time
  • price_up (number) — Price of the “Up” outcome (0-1)
  • price_down (number) — Price of the “Down” outcome (0-1)
  • orderbook_up (object, optional) — Order book for “Up” outcome
  • orderbook_down (object, optional) — Order book for “Down” outcome
​
total
integer
Total number of snapshots available

​
Examples

​
Get snapshots without order book (faster)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets/btc-updown-5m-1774581000/snapshots?coin=BTC&limit=10"

​
Get snapshots with full order book

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets/btc-updown-5m-1774581000/snapshots?coin=BTC&limit=10&include_orderbook=true"

​
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"},
          {"price": "0.50", "size": "3200"}
        ],
        "asks": [
          {"price": "0.53", "size": "1200"},
          {"price": "0.54", "size": "2800"}
        ]
      },
      "orderbook_down": {
        "bids": [
          {"price": "0.47", "size": "1400"},
          {"price": "0.46", "size": "2900"}
        ],
        "asks": [
          {"price": "0.49", "size": "1100"},
          {"price": "0.50", "size": "2600"}
        ]
      }
    }
  ],
  "total": 45,
  "limit": 10,
  "offset": 0
}
Set include_orderbook=false (default) for significantly lower latency and smaller response sizes when you only need price data.