Get a coin's total futures open interest across multiple integrated exchanges, returned as candles (open, high, low, close). Suited to watching leveraged capital flow into and out of the whole market, and whether open interest and price move in the same direction.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
The candle 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 one candle, and time is the start time of the interval. Open interest values are mostly returned as strings; in the most recent candle, which has not yet closed, some fields may be returned as numbers. Convert them all to numbers before calculating.
About theunitParameterPass lowercase
usdorcoin. Currently, only lowercasecoinreturns coin quantities; omittingunitreturns values in USD. Quantities returned withunit=coininvolve contract face values and price conversions, and must not be treated uniformly as native coin quantities reported directly by each exchange.
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 of candles; each element is one candle |
data[].time | integer (int64) | Yes | Interval start time, timestamp in milliseconds (UTC) |
data[].open | string or number | Yes | Aggregated open interest at the start of the interval; the unit is determined by unit (usd for USD, coin for the number of coins) |
data[].high | string or number | Yes | Highest aggregated open interest within the interval |
data[].low | string or number | Yes | Lowest aggregated open interest within the interval |
data[].close | string or number | Yes | Aggregated open interest at the end of the interval; for an interval that has not yet closed, the latest value |
API Plans and Available Intervals
All API plans can call this endpoint; they differ in the candle 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 Candle 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: “Has BTC's market-wide futures open interest increased or decreased over the last 7 days?”
Use Cases
| Scenario | Description |
|---|---|
| Judge Trend Strength | Rising price with increasing open interest usually indicates new capital entering; rising price with falling open interest is more likely driven by shorts closing their positions. |
| Monitor Leverage Risk | A rapid rise in open interest over a short time means leverage is building up; set up alerts together with Coin Liquidation History. |
| Build Quant Factors | Use the open interest rate of change and the degree of divergence between open interest and price as timing or risk-control factors, and run long-horizon backtests on the full daily history. |
| Generate Market Reports | Show market-wide open interest changes for major coins in daily and weekly reports to quickly convey the market's leverage level. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Open Interest OHLC History | Open interest candles for a single exchange and a single trading pair |
| Aggregated Stablecoin-Margined Open Interest (OHLC) | Market-wide open interest of stablecoin-margined futures only |
| Aggregated Coin-Margined Open Interest (OHLC) | Market-wide open interest of coin-margined futures only |
| Coin Open Interest by Exchange | Distribution of current open interest across exchanges |
| Funding Rate OHLC History | Use with open interest to judge how crowded longs or shorts are |
FAQ
Which exchanges does aggregated open interest include?
It only sums markets that this endpoint has integrated and that have data; exchanges without a corresponding trading pair or without data are not counted, so the result does not necessarily include all markets on all exchanges. Supported exchanges and trading pairs: for futures, get the list of supported exchanges and trading pairs from the Supported Exchanges and Pairs endpoint; for spot, get it from the Spot Supported Exchanges and Pairs endpoint. To specify which exchanges are included, use Aggregated Stablecoin-Margined Open Interest (OHLC) or Aggregated Coin-Margined Open Interest (OHLC), which support filtering exchanges with exchange_list.
Why do the values of the last candle keep changing?
The last candle corresponds to an interval that has not yet closed; close is the latest open interest.
Why don't the values match the exchange's official website?
This endpoint is the total across multiple exchanges; for a single exchange's values, query Open Interest OHLC History. In addition, platforms may differ in the points in time at which they take their statistics and in their pricing methods.
Learn More: Bitcoin Open Interest
What Is Open Interest (OI)?
Open interest is the total number of contracts that have not yet been closed or delivered, reflecting how much capital in the market is still holding long and short positions. Rising open interest means more positions are being opened than closed; falling open interest means capital is leaving.
How Does Bitcoin Open Interest Relate to Price?
Price and open interest rising together is often seen as the trend being backed by new capital; rising price with falling open interest is mostly driven by shorts closing positions; falling price accompanied by a sharp drop in open interest often corresponds to concentrated liquidations.
How Do I Query Open Interest for Ethereum, SOL and Other Coins?
Just change symbol to a coin such as ETH, SOL or XRP. For the list of coins you can query, see the Supported Coins endpoint.