Skip to main content

​
GET /v2/long-short-ratio

Returns long/short ratios from a specific exchange. Only exchanges with has_ls_ratio: true support this endpoint.

​
Query Parameters

​
exchange
string
Exchange ID (e.g., binance, okx).
​
symbol
string
Filter by symbol.

​
Example

curl "https://api.crypton.dev/v2/long-short-ratio?exchange=binance"

{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": [
    {
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "long_ratio": 0.55,
      "short_ratio": 0.45,
      "timestamp": 1709640000000
    }
  ]
}

​
Response Fields

​
data[].long_ratio
number
Proportion of long accounts (0–1).
​
data[].short_ratio
number
Proportion of short accounts (0–1). long_ratio + short_ratio = 1.

​
Field Reference

FieldTypeDescriptionGranularityExample
exchangestringExchange ID—"binance"
symbolstringSymbol in exchange-native format—"BTCUSDT"
long_rationumberProportion of long accounts (0–1)~30s per exchange0.55
short_rationumberProportion of short accounts (0–1). Sums to 1 with long_ratio~30s per exchange0.45
timestampintegerUnix ms when fetched~30s1709640000000

​
Data Sources

Only exchanges with has_ls_ratio: true: Binance, OKX, Bitget. Returns account-based ratios (not position-weighted).

​
Live Testing

curl -s "https://api.crypton.dev/v2/long-short-ratio?exchange=binance" | jq '.data[:3]'