---
title: "Historical"
method: GET
path: "/options/trades/{instrument}"
---

# Historical

`GET /options/trades/{instrument}`

## Request

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

Provides detailed historical trade data for a specific options instrument, including the trade's timestamp, side (buy or sell), price, volume, and other relevant metrics like the index price, mark price, and implied volatility (IV) at the time of the trade.

## Path parameters

- `instrument` string, required

## Query parameters

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

## Headers

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

## Response `200`

200

- object
  - `status` integer
  - `title` string
  - `description` string
  - `payload` object
    - `metadata` object
      - `next` unknown
      - `api-version` string
    - `data` object[]
      - `instrument` string
      - `exchange` string
      - `exchangeTimestamp` integer
      - `exchangeTimestampNanoseconds` integer
      - `isBuySide` boolean
      - `price` integer
      - `volume` number
      - `tradeId` string
      - `quoteVolume` number
      - `sequence` unknown
      - `tickDirection` unknown
      - `indexPrice` number
      - `markPrice` number
      - `underlyingIndex` unknown
      - `underlyingPrice` number
      - `iv` number

## Changes

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

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