ASasksurf
Exchange

Exchange Long/Short Ratio History

Returns historical long/short ratio for a perpetual contract.

Included fields: ratio value, long account percentage, short account percentage.

Granularity: interval supports 1h, 4h, 1d.

Pagination: use from for start time and limit for result count. For longer history, pass the last returned timestamp as the next from value.

Note: not all exchanges support historical queries via from; some only return recent data regardless.

Just pass the base pair (e.g. pair=BTC/USDT). For aggregated cross-exchange long/short ratio, see /market/futures.

get/gateway/v1/exchange/long-short-ratio

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

pairstring required

Trading pair (e.g. BTC/USDT)

Example:BTC/USDT
interval'1h' | '4h' | '1d'

Bucket size for each point in the series: 1h, 4h, or 1d. This endpoint uses interval only; it does NOT accept time_range. Use from + limit to control the window.

Example:1h
fromstring

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Binance only retains the last 30 days of data; other exchanges may have different limits.

Example:2026-03-01
limitinteger

Max number of records. For longer history, paginate using the last returned timestamp as the next from value.

Example:50
exchange'binance' | 'okx' | 'bybit' | 'bitget'

Exchange identifier

Example:binance

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseExchangeLongShortRatioItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.