Skip to main content
GET
/
futures
/
long-short-ratio
/
{instrument}
Historical
curl --request GET \
  --url https://api.amberdata.com/markets/futures/long-short-ratio/{instrument} \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "next": null,
      "api-version": "2023-09-30"
    },
    "data": [
      {
        "instrument": "BTCUSDT",
        "exchange": "binance",
        "exchangeTimestamp": 1714928400000,
        "exchangeTimestampNanoseconds": 0,
        "period": 1,
        "longAccount": 0.519,
        "shortAccount": 0.481,
        "ratio": 1.079
      },
      {
        "instrument": "BTCUSDT",
        "exchange": "binance",
        "exchangeTimestamp": 1714932000000,
        "exchangeTimestampNanoseconds": 0,
        "period": 1,
        "longAccount": 0.5179,
        "shortAccount": 0.4821,
        "ratio": 1.0743
      }
    ]
  }
}
The maximum time range (difference between startDate and endDate) is 731 days (2 years).
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours at the tick granularity.

Authorizations

​
x-api-key
string
header
required

Headers

​
Accept-Encoding
string
default:gzip, deflate, br
required
​
api-version
string

Path Parameters

​
instrument
string
default:BTCUSDT
required

The futures instrument for which data will be retrieved.

Query Parameters

​
exchange
string
default:binance
required

The exchange for which data should be retrieved. Only 1 exchange is allowed.

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>

[Optional] Payload only includes data before this date (exclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeFormat
enum<string>
default:hr

[Optional] Time format of the timestamps in the return payload.

Available options:
milliseconds,
ms*,
iso,
iso8601,
hr,
human_readable
​
timeInterval
enum<string>
default:hours

[Optional] Time interval to aggregate the historical data to.

Available options:
minutes,
hours,
days
​
metricType
enum<string>
default:default

[Optional] Specifies the long/short ratio metric to retrieve.

ValueDescription
defaultLong/short ratio across all accounts on the exchange. Available for all supported exchanges.
topTraderPositionsLong/short ratio by position size (dollar-weighted) among the top 20% of traders by margin balance. Reflects where the largest capital is allocated.
topTraderAccountsLong/short ratio by account count among top traders — each account counted once regardless of position size. Reflects how many large traders are bullish vs bearish.

[Supported exchanges] topTraderPositions and topTraderAccounts are only supported for binance. Requests using these values with other exchanges will return an empty response.

Available options:
default,
topTraderPositions,
topTraderAccounts
​
sortDirection
string

[Optional] Specifies the direction in which the data is sorted (by timestamp). [Defaults] asc (ascending order). [Usage Conditions] This parameter can only be used if the startDate and endDate timeframe is within the most recent 24 hours, or if the startDate and endDate parameters are not used at all. [Examples] ascending | descending | asc | desc

Response

200

​
status
integer
​
title
string
​
description
string
​
payload
object