Skip to main content

​
GET /v1/long-short-ratio

Returns long/short ratios showing trader positioning bias.

​
Query Parameters

​
symbol
string
Filter by symbol. Omit for all symbols.

​
Example

curl "https://api.crypton.dev/v1/long-short-ratio?symbol=BTC"

{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": {
    "symbol": "BTC",
    "average_ratio": 1.22,
    "exchanges": {
      "binance": { "long_pct": 55.0, "short_pct": 45.0, "ratio": 1.22, "updated_at": 1709639900000 },
      "okx": { "long_pct": 52.0, "short_pct": 48.0, "ratio": 1.08, "updated_at": 1709639850000 },
      "bitget": { "long_pct": 54.0, "short_pct": 46.0, "ratio": 1.17, "updated_at": 1709639800000 }
      "okx": { "long_pct": 52.0, "short_pct": 48.0, "ratio": 1.08, "updated_at": 1709639850000 }
    }
  }
}

​
Response Fields

​
data.exchanges.*.long_pct
number
Percentage of accounts positioned long (0–100).
​
data.exchanges.*.short_pct
number
Percentage of accounts positioned short. long_pct + short_pct = 100.
​
data.exchanges.*.ratio
number
Long/Short ratio. >1.0 = more longs, <1.0 = more shorts.
RatioInterpretation
> 1.50Heavily long-biased — dump risk
1.00–1.50Moderately bullish
0.80–1.00Moderately bearish
< 0.65Heavily short-biased — squeeze risk

​
Field Reference

FieldTypeDescriptionGranularityExample
average_rationumberMean L/S ratio across all reporting exchanges~30s aggregated1.22
long_pctnumberPercentage of accounts/positions that are long (0–100)~30s per exchange55.0
short_pctnumberPercentage of accounts/positions that are short (0–100)~30s per exchange45.0
rationumberlong_pct / short_pct. >1 = net long, <1 = net short~30s per exchange1.22
updated_atintegerUnix ms of last exchange fetch~30s1709639900000

​
Data Sources

L/S ratio data available from 3 exchanges: Binance (account-based), OKX (account-based), Bitget (account-based via /api/v2/mix/market/account-long-short). Other exchanges either don’t expose this data or have it behind authenticated endpoints. Ratios represent account counts, not position sizes.

​
Live Testing

# All symbols
curl -s "https://api.crypton.dev/v1/long-short-ratio" | jq .

# Single symbol
curl -s "https://api.crypton.dev/v1/long-short-ratio?symbol=BTC" | jq .