Get Snapshots

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

import requests

url = "https://api.polyhistorical.com/v1/markets/{slug}/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/{slug}/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/{slug}/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/{slug}/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/{slug}/snapshots")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.polyhistorical.com/v1/markets/{slug}/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

{slug}

snapshots

Get Snapshots

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

import requests

url = "https://api.polyhistorical.com/v1/markets/{slug}/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/{slug}/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/{slug}/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/{slug}/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/{slug}/snapshots")
  .header("X-API-Key", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.polyhistorical.com/v1/markets/{slug}/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

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

Request

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

Headers

string

required

Your API key. See Authentication.

Path parameters

string

required

The market slug, e.g. btc-updown-5m-1774975800

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/btc-updown-5m-1774975800/snapshots?limit=10"

response = requests.get(
    f"https://api.polyhistorical.com/v1/markets/{slug}/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/btc-updown-5m-1774975800/snapshots?limit=10&include_orderbook=true"

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

Response

{
  "market": {
    "slug": "btc-updown-5m-1774975800",
    "winner": "Down",
    "market_id": "1793728",
    "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 },
          { "size": 470.0, "price": 0.94 },
          { "size": 2725.25, "price": 0.93 },
          { "size": 55.0, "price": 0.92 },
          { "size": 81.5, "price": 0.91 },
          { "size": 130.04, "price": 0.9 }
        ],
        "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 },
          { "size": 470.0, "price": 0.06 },
          { "size": 2725.25, "price": 0.07 },
          { "size": 55.0, "price": 0.08 },
          { "size": 81.5, "price": 0.09 },
          { "size": 130.04, "price": 0.1 }
        ]
      }
    },
    {
      "time": "2026-03-31T16:54:59.464320Z",
      "coin_price": 67673.18,
      "price_up": 0.455,
      "price_down": 0.545,
      "orderbook_up": {
        "asks": [
          { "size": 3488.68, "price": 0.99 },
          { "size": 2081.11, "price": 0.98 },
          { "size": 798.23, "price": 0.97 },
          { "size": 104.0, "price": 0.96 },
          { "size": 335.0, "price": 0.95 },
          { "size": 470.0, "price": 0.94 },
          { "size": 475.25, "price": 0.93 },
          { "size": 55.0, "price": 0.92 },
          { "size": 81.5, "price": 0.91 },
          { "size": 90.04, "price": 0.9 }
        ],
        "bids": []
      },
      "orderbook_down": {
        "asks": [],
        "bids": [
          { "size": 3488.68, "price": 0.01 },
          { "size": 2081.11, "price": 0.02 },
          { "size": 798.23, "price": 0.03 },
          { "size": 104.0, "price": 0.04 },
          { "size": 335.0, "price": 0.05 },
          { "size": 470.0, "price": 0.06 },
          { "size": 475.25, "price": 0.07 },
          { "size": 55.0, "price": 0.08 },
          { "size": 81.5, "price": 0.09 },
          { "size": 90.04, "price": 0.1 }
        ]
      }
    }
  ],
  "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 Market Get Snapshots by Market ID

Getting Started

API Reference

Guides

Get Snapshots

Get Snapshots

Request

Headers

Path parameters

Query parameters

Response

Examples

Get snapshots without order book (faster)

Get snapshots with full order book

Response

​Get Snapshots

​Request

​Headers

​Path parameters

​Query parameters

​Response

​Examples

​Get snapshots without order book (faster)

​Get snapshots with full order book

​Response

Get Snapshots

Request

Headers

Path parameters

Query parameters

Response

Examples

Get snapshots without order book (faster)

Get snapshots with full order book

Response