March 31, 2026
The Futures Long/Short Ratio endpoint now supports an optionalmetricType parameter, giving you more granular control over which ratio metric is returned.
| Value | Description |
|---|---|
default | Long/short ratio across all accounts on the exchange. Available for all supported exchanges. |
topTraderPositions | (Binance only) Dollar-weighted long/short ratio among the top 20% of traders by margin balance. Reflects where the largest capital is allocated. |
topTraderAccounts | (Binance only) Account-count-based long/short ratio among the top 20% of traders. Each account is counted once regardless of position size, reflecting how many large traders are bullish vs bearish. |
metricType is omitted, the endpoint behaves as before and returns the default metric.
Note:topTraderPositionsandtopTraderAccountsare only supported forbinance. Requests using these values with other exchanges will return a200 OKwith an emptydataarray.
Why does this matter?
Tracking sentiment across all accounts can be noisy. Retail traders make up the majority and often trade in the opposite direction of the market’s eventual move. By isolating top trader data, you can cut through that noise and focus on the positioning of the participants most likely to have an informed edge. UsetopTraderPositions to see where the largest capital is actually deployed, or topTraderAccounts to gauge directional consensus among experienced traders independent of position size.