Top Trader Long/Short Ratio (Positions)

Type: NONE

Weight: 1

GET /futures/data/topLongShortPositionRatio

Long/short ratio of the top 20 % of accounts by position size, weighted by USD notional. Public endpoint: no X-MBX-APIKEY, timestamp or signature required.

Request

GET /futures/data/topLongShortPositionRatio?symbol=BTCUSDT

Query params

Name	Type	Required	Default	Notes
symbol	string	yes	—
period	string	no	5m	Ignored — only the latest value is computed.
limit	integer	no	30	Effectively 1.
startTime / endTime	long	no	—	Ignored.

Response — 200

[
  {
    "symbol": "BTCUSDT",
    "longShortRatio": "1.2500",
    "longAccount": "0.5556",
    "shortAccount": "0.4444",
    "timestamp": "1714261234567"
  }
]

Computed live from open positions: accounts are ranked by size_in_usd, the top quintile (NTILE(5) = 1) is taken, and the long/short USD notional is compared. Only the latest point is returned — there is no time series yet.