---
title: "Get Spot Orderbook Snapshots"
method: GET
path: "/v2/spot/snapshots"
tags: ["v2 - Spot"]
---

# Get Spot Orderbook Snapshots

`GET /v2/spot/snapshots`

Get historical spot orderbook snapshots with pagination. Timestamps accept millisecond epoch or ISO8601 format.

<Info>Learn how to query effectively using time filters and pagination limits in our [Fetching Data & Pagination](/fetching-data) guide.</Info>

<Info>Check the [Available Data & Markets](/available-data) guide to see which market types are supported for each coin.</Info>

## Query parameters

- `coin` string, required
- `start_time` string
- `end_time` string
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- PaginatedSnapshots
  - `snapshots` Snapshot[], required
    - `id` integer, required
    - `price` number, required
    - `bids` unknown, required
    - `asks` unknown, required
    - `timestamp` string, required — Source timestamp from Binance (ISO8601)
  - `total` integer, required — Total number of matching snapshots
  - `limit` integer, required — Results per page
  - `offset` integer, required — Current pagination offset

## Other responses

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