---
title: "Get Market Snapshots"
method: GET
path: "/v2/markets/{market_id}/snapshots"
tags: ["v2 - Snapshots"]
---

# Get Market Snapshots

`GET /v2/markets/{market_id}/snapshots`

Get snapshots for a market with pagination.

Returns snapshots sorted by time ascending (oldest first).
Maximum limit is 1000 snapshots per request.

By default, include_orderbook=false for lower-latency, lighter responses. Set include_orderbook=true when you need full orderbook depth.

## Path parameters

- `market_id` string, required

## Query parameters

- `coin` string, required
- `include_orderbook` boolean
- `limit` integer
- `offset` integer
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable

## Response `200`

Successful Response

- SnapshotsListResponse — Paginated snapshots list response with market data.
  - `market` MarketResponse, required — Single market response.
    - `market_id` string, required
    - `event_id` string, required
    - `slug` string, required
    - `market_type` string, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `{coin}_price_start` number, nullable — Coin price (USD) at market start. Field name depends on the coin queried: btc_price_start, eth_price_start, sol_price_start, etc.
    - `condition_id` string, nullable
    - `clob_token_up` string, nullable
    - `clob_token_down` string, nullable
    - `winner` string, nullable
    - `final_volume` number, nullable
    - `final_liquidity` number, nullable
    - `{coin}_price_end` number, nullable — Coin price (USD) at market end/resolution. Field name depends on the coin queried: btc_price_end, eth_price_end, sol_price_end, etc.
    - `resolved_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `snapshots` SnapshotResponse[], required — Array of market snapshots
    - `id` integer, required — Unique snapshot identifier
    - `time` string, date-time, required — Timestamp when the snapshot was captured (ISO8601)
    - `market_id` string, required — ID of the market this snapshot belongs to
    - `{coin}_price` number, nullable — Coin price at the time of snapshot (USD). Field name depends on the coin queried: btc_price, eth_price, sol_price, etc.
    - `price_up` number, nullable — Best price for the UP token (0-1 range)
    - `price_down` number, nullable — Best price for the DOWN token (0-1 range)
    - `orderbook_up` OrderBookResponse — Order book containing bid and ask orders.
      - `bids` OrderBookEntry[], required — List of bid orders (buy orders), sorted by price descending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
      - `asks` OrderBookEntry[], required — List of ask orders (sell orders), sorted by price ascending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
    - `orderbook_down` OrderBookResponse — Order book containing bid and ask orders.
      - `bids` OrderBookEntry[], required — List of bid orders (buy orders), sorted by price descending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
      - `asks` OrderBookEntry[], required — List of ask orders (sell orders), sorted by price ascending
        - `price` number, required — Order price (0-1 range)
        - `size` number, required — Order size in tokens
  - `total` integer, required — Total number of snapshots available for this market
  - `limit` integer, required — Number of results returned in this response
  - `offset` integer, required — Pagination offset used for this request

## Other responses

- `401` — Missing or invalid API key
- `404` — Market not found
- `422` — Validation Error

---

[API](https://skmtc.dev/polybacktest/apis/polybacktest-api.md) · [All operations](https://skmtc.dev/polybacktest/apis/polybacktest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polybacktest/polybacktest-api/revisions/262c9a5e60e4/schema)