Get Snapshots by Market ID

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

import requests

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

headers = {"X-API-Key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

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

GET

markets

by-market-id

{marketId}

snapshots

Get Snapshots by Market ID

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

import requests

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

headers = {"X-API-Key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};

fetch('https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.polyhistorical.com/v1/markets/by-market-id/{marketId}/snapshots")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "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

string

required

Your API key. See Authentication.

Path parameters

string

required

The Polymarket market ID, e.g. 1843290

Query parameters

integer

default:"1000"

Number of snapshots to return (1-1000)

integer

default:"0"

Pagination offset

boolean

default:"false"

Include full order book data (bids and asks) in each snapshot. Set to false for lower latency.

Response

object

The market object (same as Get Market)

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

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/by-market-id/1843290/snapshots?limit=10"

response = requests.get(
    f"https://api.polyhistorical.com/v1/markets/by-market-id/{market_id}/snapshots",
    params={"limit": 10},
    headers={"X-API-Key": API_KEY}
)

Get snapshots with full order book

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 = requests.get(
    f"https://api.polyhistorical.com/v1/markets/by-market-id/{market_id}/snapshots",
    params={"limit": 10, "include_orderbook": True},
    headers={"X-API-Key": API_KEY}
)

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.

Get Snapshots Replay Strategy

Getting Started

API Reference

Guides

Get Snapshots by Market ID

Get Snapshots by Market ID

Request

Headers

Path parameters

Query parameters

Response

Examples

Get snapshots without order book (faster)

Get snapshots with full order book

Response

​Get Snapshots by Market ID

​Request

​Headers

​Path parameters

​Query parameters

​Response

​Examples

​Get snapshots without order book (faster)

​Get snapshots with full order book

​Response

Get Snapshots by Market ID

Request

Headers

Path parameters

Query parameters

Response

Examples

Get snapshots without order book (faster)

Get snapshots with full order book

Response