---
title: "Snapshots Historical"
method: GET
path: "/spot/order-book-snapshots/{instrument}"
---

# Snapshots Historical

`GET /spot/order-book-snapshots/{instrument}`

## Request

- Base URL: `https://api.amberdata.com/markets`
- URL: `https://api.amberdata.com/markets/spot/order-book-snapshots/{instrument}`
- Auth: API key in header `x-api-key`

Delivers historical order book snapshots for specified Spot market trading pairs, including detailed bid and ask levels, volume, and order count per price level, along with timestamps to track market depth over time.

## Path parameters

- `instrument` string, required

## Query parameters

- `exchange` string, required
- `startDate` string
- `endDate` string
- `maxLevel` integer
- `timestamp` string
- `timeFormat` 'milliseconds' | 'ms*' | 'iso' | 'iso8601' | 'hr' | 'human_readable'
- `sortDirection` string

## Headers

- `Accept-Encoding` string, required
- `api-version` string

## Response `200`

200

- object
  - `status` integer
  - `title` string
  - `description` string
  - `payload` object
    - `metadata` object
      - `requestedStartDate` integer
      - `requestedEndDate` integer
      - `returnedStartDate` integer
      - `returnedEndDate` integer
      - `next` string
      - `api-version` string
    - `data` object[]
      - `exchange` string
      - `instrument` string
      - `timestamp` integer
      - `sequence` string
      - `ask` object[]
        - `price` number
        - `volume` number
        - `numOrders` integer

## Changes

- **2026-11-03** `20cba0305b6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/amberdata/apis/market-api/changes/spot/order-book-snapshots/:instrument/get.md)

---

[API](https://skmtc.dev/amberdata/apis/market-api.md) - [All operations](https://skmtc.dev/amberdata/apis/market-api/llms.txt) - [OpenAPI document](https://skmtc.dev/amberdata/apis/market-api/revisions/20cba0305b6e?raw)