Futures — Long/Short Ratio

GET /futures/long-short/:symbol

Top traders long/short position ratio across major exchanges.

Cost: $0.02 USDC

Path Parameters

Param	Type	Description
symbol	string	Symbol (e.g. BTC, ETH, SOL)

Request Example

curl -H "x-payment: <proof>" \
  https://api.foursec.xyz/futures/long-short/ETH

Response

{
  "symbol": "ETH",
  "timestamp": "2026-07-08T14:30:00Z",
  "exchanges": {
    "binance": {
      "long_ratio": 0.62,
      "short_ratio": 0.38,
      "ls_ratio": 1.63,
      "source": "top_traders"
    },
    "okx": {
      "long_ratio": 0.58,
      "short_ratio": 0.42,
      "ls_ratio": 1.38,
      "source": "top_traders"
    },
    "bybit": {
      "long_ratio": 0.55,
      "short_ratio": 0.45,
      "ls_ratio": 1.22,
      "source": "top_traders"
    }
  },
  "aggregate": {
    "avg_ls_ratio": 1.41,
    "sentiment": "bullish",
    "interpretation": "Top traders are 1.41x more long than short — net bullish positioning"
  }
}

Sentiment Thresholds

L/S Ratio	Sentiment
> 2.0	Extremely bullish (contrarian caution)
1.5 – 2.0	Bullish
1.0 – 1.5	Slightly bullish
~1.0	Neutral
0.67 – 1.0	Slightly bearish
< 0.67	Bearish / Extremely bearish

Note

Contrarian use: extremely high L/S ratios can signal an imminent long squeeze, as the market tends to move against crowded positions.

Data Source

Binance FAPI /futures/data/topLongShortPositionRatio (primary), CCXT fallback for OKX/Bybit. Cache TTL: 30 seconds.