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

# Snapshots Historical

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

## Request

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

Provides detailed historical snapshots of options order books, including bid and ask levels, underlying prices, market statistics, open interest, and Greeks, enabling in-depth analysis of market depth and options pricing over time across supported exchanges.

## Path parameters

- `instrument` string, required

## Query parameters

- `exchange` string, required
- `startDate` string, date-time
- `endDate` string, date-time
- `timestamp` string
- `timeFormat` string
- `sortDirection` string
- `maxLevel` integer

## Headers

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

## Response `200`

200

- object
  - `status` integer
  - `title` string
  - `description` string
  - `payload` object
    - `metadata` object
      - `next` string: Cursor for pagination
      - `api-version` string: API version used
    - `data` object[]
      - `timestamp` integer
      - `instrument` string
      - `exchange` string
      - `exchangeTimestamp` integer
      - `exchangeTimestampNanoseconds` integer
      - `sequence` string
      - `underlyingPrice` number
      - `underlyingIndex` string
      - `low` number
      - `high` number
      - `volume` number
      - `volumeUSD` number
      - `priceChange` number
      - `openInterest` number
      - `minPrice` number
      - `maxPrice` number
      - `markPrice` number
      - `markIv` number
      - `lastPrice` number
      - `interestRate` number
      - `indexPrice` number
      - `estimatedDeliveryPrice` number
      - `rho` number
      - `vega` number
      - `delta` number
      - `gamma` number
      - `theta` number
      - `bidIv` number
      - `askIv` number
      - `bestBidPrice` number
      - `bestAskPrice` number
      - `bestBidVolume` number
      - `bestAskVolume` number
      - `state` string
      - `ask` object[]
        - `price` number
        - `volume` number
        - `numOrders` integer, nullable
      - `bid` object[]
        - `price` number
        - `volume` number
        - `numOrders` integer, nullable

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/amberdata/apis/market-api/changes/options/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)