---
title: "Historical"
method: GET
path: "/futures/long-short-ratio/{instrument}"
---

# Historical

`GET /futures/long-short-ratio/{instrument}`

## Request

- Base URL: `https://api.amberdata.com/markets`
- URL: `https://api.amberdata.com/markets/futures/long-short-ratio/{instrument}`
- Auth: API key in header `x-api-key`

Provides historical long/short ratio data for futures instruments, including timestamps, long and short account distributions, and ratio values across exchanges.

## Path parameters

- `instrument` string, required

## Query parameters

- `exchange` string, required
- `startDate` string, date-time
- `endDate` string, date-time
- `timeFormat` 'milliseconds' | 'ms*' | 'iso' | 'iso8601' | 'hr' | 'human_readable'
- `timeInterval` 'minutes' | 'hours' | 'days'
- `metricType` 'default' | 'topTraderPositions' | 'topTraderAccounts'
- `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` string
      - `api-version` string
    - `data` object[]
      - `instrument` string
      - `exchange` string
      - `exchangeTimestamp` integer
      - `exchangeTimestampNanoseconds` integer
      - `period` integer: The number of `timeInterval` units per data point. **Example:** - `timeInterval=minutes`, `period=5` → 5-minute buckets - `timeInterval=hours`, `period=1` → 1-hour buckets - `timeInterval=days`, `period=1` → 1-day buckets
      - `longAccount` number
      - `shortAccount` number
      - `ratio` number

## Other responses

- `400`: 400

## Changes

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

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