---
title: "List market snapshots"
method: GET
path: "/v3/{coin}/markets/{market_id}/snapshots"
tags: ["v3 - Markets"]
---

# List market snapshots

`GET /v3/{coin}/markets/{market_id}/snapshots`

Cursor-paginated snapshots for a market. Pass `include_orderbook=true` for full bid/ask depth.

## Path parameters

- `coin` 'btc' | 'eth' | 'sol', required
- `market_id` string, required

## Query parameters

- `start_time` string
- `end_time` string
- `include_orderbook` boolean
- `limit` integer
- `cursor` string
- `include_count` boolean

## Response `200`

Successful response

- V3SnapshotsListResponse
  - `data` V3PolymarketSnapshot[], required
    - `id` integer, required
    - `time` string, date-time, required
    - `market_id` string, required
    - `{coin}_price` number, nullable — Coin price at snapshot time, named per coin queried
    - `price_up` number, nullable
    - `price_down` number, nullable
    - `orderbook_up` object, nullable — Only included when ?include_orderbook=true
    - `orderbook_down` object, nullable — Only included when ?include_orderbook=true
  - `pagination` V3Pagination, required — Cursor pagination metadata. `total_count` is omitted unless `?include_count=true` is passed.
    - `next_cursor` string, nullable — Opaque cursor; pass back as `?cursor=` to fetch the next page
    - `has_more` boolean, required
    - `limit` integer, required
    - `count` integer, required — Number of items in this page
    - `total_count` integer, nullable — Only set when ?include_count=true (expensive)
  - `meta` V3Meta, required — Per-response metadata included on every v3 response.
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `400` — Validation error (invalid coin, cursor, parameter, timestamp, …)
- `401` — Authentication failure (missing or invalid API key)
- `402` — Plan upgrade required
- `403` — Endpoint or coin not in the caller's plan
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[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)