Get Snapshots by Market ID

Get time-series snapshots for a market using its Polymarket market ID

GET /v1/markets/by-market-id/{marketId}/snapshots

Get Snapshots by Market ID

cURL

curl --request GET \
  --url https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots \
  --header 'X-API-Key: <x-api-key>'

200

{
  "market": {},
  "snapshots": [
    {}
  ],
  "total": 123
}

Get Snapshots by Market ID

Returns the market details along with its time-series snapshots, including price data and optional order book depth. This endpoint is identical to Get Snapshots but uses the Polymarket market ID instead of the slug.

Use this endpoint when you have the Polymarket market ID (e.g. 1843290) but not the slug. The response format is the same as the slug-based endpoint.

Request

https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots

Headers

X-API-Key · string · required

Your API key. See Authentication.

Path parameters

marketId · string · required

The Polymarket market ID, e.g. 1843290

Query parameters

limit · integer · default: "1000"

Number of snapshots to return (1-1000)

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)
• coin_price (number) — Coin 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

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets/by-market-id/1843290/snapshots?limit=10"

Get snapshots with full order book

cURL

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.polyhistorical.com/v1/markets/by-market-id/1843290/snapshots?limit=10&include_orderbook=true"

Response

{
  "market": {
    "slug": "btc-updown-5m-1774975800",
    "winner": "Down",
    "market_id": "1843290",
    "event_id": "325933",
    "market_type": "5m",
    "start_time": "2026-03-31T16:50:00Z",
    "end_time": "2026-03-31T16:55:00Z",
    "coin_price_start": 67701.82777476,
    "condition_id": "0x740cfdbafa8d1b1d51729da79b05e641158d3a7c889175dab1eab20a2c92b5cc",
    "clob_token_up": "83511279567738325562016865404511480598726292757090195771777541218161914729159",
    "clob_token_down": "66091509674921971407227514952521456996907573303653223323107401767726760115252",
    "final_volume": 202849.44,
    "final_liquidity": 12435.04,
    "coin_price_end": 67611.61304387,
    "resolved_at": "2026-03-31T16:55:25Z",
    "created_at": "2026-03-31T16:50:00.943587Z",
    "updated_at": "2026-03-31T17:21:20.768590Z"
  },
  "snapshots": [
    {
      "time": "2026-03-31T16:54:59.956459Z",
      "coin_price": 67673.18,
      "price_up": 0.455,
      "price_down": 0.545,
      "orderbook_up": {
        "asks": [
          { "size": 3999.68, "price": 0.99 },
          { "size": 2081.11, "price": 0.98 },
          { "size": 798.23, "price": 0.97 },
          { "size": 2604.0, "price": 0.96 },
          { "size": 335.0, "price": 0.95 }
        ],
        "bids": []
      },
      "orderbook_down": {
        "asks": [],
        "bids": [
          { "size": 3999.68, "price": 0.01 },
          { "size": 2081.11, "price": 0.02 },
          { "size": 798.23, "price": 0.03 },
          { "size": 2604.0, "price": 0.04 },
          { "size": 335.0, "price": 0.05 }
        ]
      }
    }
  ],
  "total": 878,
  "limit": 10,
  "offset": 0
}

Response truncated — 10 snapshots are returned with limit=10. Each snapshot includes full order book data when include_orderbook=true.

Set include_orderbook=false (default) for significantly lower latency and smaller response sizes when you only need price data.