Get the long/short ratio history across all accounts for a futures trading pair on an exchange: the share of accounts holding longs, the share holding shorts, and the ratio between the two. Useful for seeing whether overall retail sentiment leans long or short.
| 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 is the data for one interval, and time is the start time of the interval. Values are returned as numbers. The statistics here cover all accounts for the trading pair and are calculated by number of accounts, regardless of each account's position size.
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[].global_account_long_percent | number | Yes | Long share among all accounts, in % |
data[].global_account_short_percent | number | Yes | Short share among all accounts, in % |
data[].global_account_long_short_ratio | number | Yes | Long/short ratio among all 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: “What is the current account long/short ratio of BTCUSDT on Binance? Has it been rising or falling over the past week?”
Use Cases
| Scenario | Description |
|---|---|
| Gauge Retail Sentiment | The long/short ratio across all accounts reflects the directional preference of most traders; the higher the ratio, the more accounts hold longs. |
| Look for Contrarian Signals | When the long/short ratio stays at an extreme high or low for a long time, the market is often too crowded on one side, which can serve as a contrarian reference. |
| Compare with Top Traders | Compare with Top Trader Long/Short Account Ratio History to see whether retail traders and top traders agree. |
| Build Quant Factors | Use changes in the long/short ratio and how far it deviates from its mean as sentiment factors, and backtest them together with price. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Top Trader Long/Short Account Ratio History | Counts top trader accounts only, calculated by number of accounts |
| Top Trader Long/Short Position Ratio History | Counts top traders only, calculated by position size |
| Coin Taker Buy/Sell Ratio | Ratio of taker buy to taker sell trading volume |
| Open Interest OHLC History | Changes in open interest for the same trading pair |
| Supported Exchanges and Pairs | Look up the accepted values of symbol |
FAQ
What does a long/short ratio of 1.68 mean?
It means the number of accounts holding longs is 1.68 times the number of accounts holding shorts. It is calculated only by number of accounts and does not mean that longs have 1.68 times as much capital as shorts.
Do percentage fields such as 62.62 need to be multiplied by 100?
No. Fields such as global_account_long_percent are already percentage values; 62.62 is 62.62%.
Why can't I get data when I switch to another exchange?
This endpoint currently supports only five exchanges: Binance, OKX, Bybit, Gate and HTX. Also, symbol must be the trading pair as written by that exchange, e.g., BTCUSDT, not BTC.
Why does the number of data points returned differ from limit?
When both start_time and end_time are passed, the number of data points returned is mainly determined by the time range and interval, and is also 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: Futures Long/Short Account Ratio
What Is the Account Long/Short Ratio?
The account long/short ratio is the number of accounts holding longs divided by the number of accounts holding shorts. It reflects how many people are bullish and how many are bearish, not how much capital each side has committed.
Does a High Long/Short Ratio Mean Price Will Rise?
Not necessarily. A high long/short ratio only means that many accounts are bullish. When longs are too concentrated, a price drop can easily trigger a cluster of long liquidations. The long/short ratio works better as a sentiment reference and should be judged together with open interest and price.
How Is the Account Long/Short Ratio Different from the Top Trader Long/Short Ratio?
The account long/short ratio counts all accounts and is closer to retail sentiment; the top trader long/short ratio counts top traders only. See Top Trader Long/Short Account Ratio History and Top Trader Long/Short Position Ratio History.
