Get the top trader long/short account ratio history for a futures trading pair on a given exchange: the shares of top trader accounts holding long and short positions, and the ratio between the two. Useful for observing the directional bias of top traders.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
The data intervals you can query differ by API plan; see API Plans and Available Intervals below on this page.
Response Data
data is an array; each element holds the data for one interval, and time is the start time of the interval. Values are returned as numbers. Only top trader accounts are counted, by number of accounts, without regard to the position size of each account.
Shares Are Percentage Values; the Long/Short Ratio Is a Ratio
*_long_percentand*_short_percentare in %:62.62means 62.62%, so there is no need to multiply by 100, and the two add up to about 100.*_long_short_ratiois the long share ÷ the short share:1.68means longs are 1.68 times shorts; it is not a percentage value.
200 · application/json · See the response example in the right panel.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message |
data | array of object | Yes | Array sorted by time; each element is one interval |
data[].time | integer (int64) | Yes | Interval start time, timestamp in milliseconds (UTC) |
data[].top_account_long_percent | number | Yes | Long share among top trader accounts, in % |
data[].top_account_short_percent | number | Yes | Short share among top trader accounts, in % |
data[].top_account_long_short_ratio | number | Yes | Long/short ratio among top trader accounts: long share ÷ short share |
API Plans and Available Intervals
All API plans can call this endpoint; they differ in the data intervals they can query: the lower the plan, the longer the shortest available interval. For the price of each plan, see API Plans.
| API Plan | Access | Available Data Intervals (interval Parameter) |
|---|---|---|
| Hobbyist | ✅ Yes | 4 hours and above: 4h, 6h, 8h, 12h, 1d, 1w |
| Startup | ✅ Yes | 30 minutes and above: 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w |
| Standard | ✅ Yes | All intervals, minimum 1 minute (1m) |
| Professional | ✅ Yes | All intervals, minimum 1 minute (1m) |
| Enterprise | ✅ Yes | All intervals, minimum 1 minute (1m) |
For how much historical data each interval can query, see Intervals.
Use This Endpoint with AI
Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.
Want AI to query real-time data without writing code? Connect CoinGlass MCP in Claude or Cursor and ask in plain language, for example: “Are top traders on Binance currently leaning long or short on BTCUSDT?”
Use Cases
| Scenario | Description |
|---|---|
| Track Top Trader Direction | The top trader long/short account ratio shows how many top traders are bullish and how many are bearish. |
| Compare with Retail Sentiment | Compare with Global Long/Short Account Ratio History; it is worth paying attention when top traders and all accounts point in opposite directions. |
| Factor In Position Size | Compare with Top Trader Long/Short Position Ratio History to judge whether top traders lean long by number of accounts or by position size. |
| Build Quant Factors | Use changes in the top trader long/short ratio as a sentiment factor and backtest it on a single trading pair. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Global Long/Short Account Ratio History | Counts all accounts; closer to retail sentiment |
| Top Trader Long/Short Position Ratio History | Also covers only top traders, but calculated by position size |
| Coin Taker Buy/Sell Ratio | Ratio of taker buy to taker sell trading volume (USD) |
| Open Interest OHLC History | Open interest changes for the same trading pair |
| Supported Exchanges and Pairs | Look up valid values for symbol |
FAQ
What is the difference between the top trader long/short account ratio and the top trader long/short position ratio?
The account ratio is calculated by the number of top trader accounts, with each account counting as one; the position ratio is calculated by the position size of top traders, so accounts with larger positions have more influence. The two can point in different directions.
Should I multiply a percentage field such as 64.31 by 100?
No. Fields such as top_account_long_percent are already percentage values; 64.31 is 64.31%.
Why do I get no data when I switch to another exchange or coin?
This endpoint currently supports only five exchanges: Binance, OKX, Bybit, Gate and HTX. Of these, OKX supports only XRP, BTC, LINK, FIL, BCH, ETH, ETC, ADA, LTC, DOT and TRX; Bybit supports only BTC, ETH, SOL, XRP, DOGE, TON, LTC, BCH and ADA. Also, symbol must use that exchange's trading pair format, e.g., BTCUSDT, not BTC.
Why does the number of returned data points differ from limit?
When both start_time and end_time are passed, the number of data points returned is determined mainly by the time range and interval, and can also be affected by missing data, so it does not necessarily equal limit. If you only want the most recent N data points, pass only limit and omit the start and end times.
Learn More: Top Trader Long/Short Account Ratio
What Is the Top Trader Long/Short Account Ratio?
It measures, among the top traders as defined by the exchange, the shares of accounts holding long positions and accounts holding short positions. A ratio above 1 means more top traders are bullish. Exchanges may use different criteria to define top traders, so keep this in mind when comparing across exchanges.
Why Look at Top Traders Separately?
Top traders have large amounts of capital, and their directional bias is often treated as a more useful signal than that of retail traders. It is worth paying attention when top traders and retail traders point in opposite directions, but this is only a reference and cannot be used on its own to judge whether the price will rise or fall.
How Do I See the Actual Position Bias of Top Traders?
The account count reflects only the number of traders; to see position size, use Top Trader Long/Short Position Ratio History.