Coin Markets

Get a summary of market metrics for each futures coin: price, market cap, open interest, funding rate, long/short ratio, trading volume and liquidation amounts, plus changes over periods from 5 minutes to 24 hours. Useful for coin rankings, coin screening and market dashboards.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Available on these API plans: Standard Professional Enterprise

Response Data

data is an array; each element is the futures market summary of one coin. The scope of the statistics is determined by exchange_list; results are sorted by open_interest_usd from highest to lowest and paged with page and per_page. When symbol_list is passed, coins are filtered first, then sorted and paged. Fields whose names contain volume_change compare rolling 24-hour trading volume: for example, volume_change_percent_4h is the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 4 hours ago, not a period-over-period change in the trading volume of the last 4 hours. The example on the right is an actual response for exchange_list=Binance and per_page=2, so open interest, trading volume and other values are Binance data only.

📘

Changes and funding rates are already percentage values

Fields whose names contain percent, as well as avg_funding_rate_by_oi and avg_funding_rate_by_vol, are all in %: 0.82 means 0.82%; do not multiply by 100 again. *_ratio fields (e.g., open_interest_market_cap_ratio, long_short_ratio_*) are plain ratios, not percentage values.

🚧

volume_change_usd_1h is not a 1-hour change

The field name suggests the 1-hour change in trading volume (USD), but it currently returns the futures trading volume over the past 24 hours. Its value is clearly larger than the 4-hour and 24-hour changes and roughly equals the sum of long_volume_usd_24h and short_volume_usd_24h. Do not use it as a 1-hour change.

200 · application/json · See the response example in the right panel.

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message; contains the error message when an error occurs
dataarray of objectYesList of coins; each element is the futures market summary of one coin
data[].symbolstringYesCoin symbol
data[].current_pricenumberYesCurrent price, in USD
data[].avg_funding_rate_by_oinumberNoOI-weighted average funding rate, in % (0.01 means 0.01%)
data[].avg_funding_rate_by_volnumberNoVolume-weighted average funding rate, in %
data[].market_cap_usdnumberNoMarket cap, in USD
data[].open_interest_market_cap_rationumberNoRatio of open interest to market cap, a plain ratio (0.03 means open interest is about 3% of market cap)
data[].open_interest_usdnumberYesOpen interest, in USD
data[].open_interest_quantitynumberYesOpen interest quantity, in number of coins
data[].open_interest_volume_rationumberNoRatio of open interest to volume, a plain ratio
data[].oi_vol_ratio_change_percent_1hnumberNo1-hour change in the ratio of open interest to volume, in %
data[].oi_vol_ratio_change_percent_4hnumberNo4-hour change in the ratio of open interest to volume, in %
data[].oi_vol_ratio_change_percent_24hnumberNo24-hour change in the ratio of open interest to volume, in %
data[].oi_vol_rationumberNoRatio of open interest to volume, the same as open_interest_volume_ratio
data[].price_change_percent_5mnumberNo5-minute price change percentage, in %
data[].price_change_percent_15mnumberNo15-minute price change percentage, in %
data[].price_change_percent_30mnumberNo30-minute price change percentage, in %
data[].price_change_percent_1hnumberNo1-hour price change percentage, in %
data[].price_change_percent_4hnumberNo4-hour price change percentage, in %
data[].price_change_percent_12hnumberNo12-hour price change percentage, in %
data[].price_change_percent_24hnumberNo24-hour price change percentage, in %
data[].open_interest_change_percent_5mnumberNo5-minute open interest change percentage, in %
data[].open_interest_change_percent_15mnumberNo15-minute open interest change percentage, in %
data[].open_interest_change_percent_30mnumberNo30-minute open interest change percentage, in %
data[].open_interest_change_percent_1hnumberNo1-hour open interest change percentage, in %
data[].open_interest_change_percent_4hnumberNo4-hour open interest change percentage, in %
data[].open_interest_change_percent_24hnumberNo24-hour open interest change percentage, in %
data[].open_interest_change_usd_5mnumberNo5-minute open interest change, in USD
data[].open_interest_change_usd_15mnumberNo15-minute open interest change, in USD
data[].open_interest_change_usd_30mnumberNo30-minute open interest change, in USD
data[].open_interest_change_usd_1hnumberNo1-hour open interest change, in USD
data[].open_interest_change_usd_4hnumberNo4-hour open interest change, in USD
data[].open_interest_change_usd_24hnumberNo24-hour open interest change, in USD
data[].volume_change_percent_5mnumberNo5-minute trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 5 minutes ago, not a period-over-period change in the trading volume of the last 5 minutes. As of 2026-10-20 this field is not returned; check whether it exists before reading it
data[].volume_change_percent_15mnumberNo15-minute trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 15 minutes ago, not a period-over-period change in the trading volume of the last 15 minutes. As of 2026-10-20 this field is not returned; check whether it exists before reading it
data[].volume_change_percent_30mnumberNo30-minute trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 30 minutes ago, not a period-over-period change in the trading volume of the last 30 minutes. As of 2026-10-20 this field is not returned; check whether it exists before reading it
data[].volume_change_percent_1hnumberNo1-hour trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 1 hour ago, not a period-over-period change in the trading volume of the last 1 hour
data[].volume_change_percent_4hnumberNo4-hour trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 4 hours ago, not a period-over-period change in the trading volume of the last 4 hours
data[].volume_change_percent_24hnumberNo24-hour trading volume change percentage, in %: the change in the current past-24-hour trading volume relative to the past-24-hour trading volume as of 24 hours ago, not a period-over-period change in the trading volume of the last 24 hours
data[].volume_change_usd_1hnumberNoThe field name suggests the 1-hour change in trading volume, but it currently returns the futures trading volume over the past 24 hours (USD), not a 1-hour change. The value roughly equals the sum of long_volume_usd_24h and short_volume_usd_24h
data[].volume_change_usd_4hnumberNo4-hour trading volume change, in USD: the current past-24-hour trading volume minus the past-24-hour trading volume as of 4 hours ago
data[].volume_change_usd_24hnumberNo24-hour trading volume change, in USD: the current past-24-hour trading volume minus the past-24-hour trading volume as of 24 hours ago
data[].long_short_ratio_5mnumberNoLong/short ratio (last 5 minutes), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_15mnumberNoLong/short ratio (last 15 minutes), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_30mnumberNoLong/short ratio (last 30 minutes), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_1hnumberNoLong/short ratio (last 1 hour), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_4hnumberNoLong/short ratio (last 4 hours), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_12hnumberNoLong/short ratio (last 12 hours), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_short_ratio_24hnumberNoLong/short ratio (last 24 hours), i.e., taker buy volume ÷ taker sell volume in that period
data[].long_volume_usd_5mnumberNoTaker buy (long) volume over the last 5 minutes, in USD
data[].short_volume_usd_5mnumberNoTaker sell (short) volume over the last 5 minutes, in USD
data[].long_volume_usd_15mnumberNoTaker buy (long) volume over the last 15 minutes, in USD
data[].short_volume_usd_15mnumberNoTaker sell (short) volume over the last 15 minutes, in USD
data[].long_volume_usd_30mnumberNoTaker buy (long) volume over the last 30 minutes, in USD
data[].short_volume_usd_30mnumberNoTaker sell (short) volume over the last 30 minutes, in USD
data[].long_volume_usd_1hnumberNoTaker buy (long) volume over the last 1 hour, in USD
data[].short_volume_usd_1hnumberNoTaker sell (short) volume over the last 1 hour, in USD
data[].long_volume_usd_4hnumberNoTaker buy (long) volume over the last 4 hours, in USD
data[].short_volume_usd_4hnumberNoTaker sell (short) volume over the last 4 hours, in USD
data[].long_volume_usd_12hnumberNoTaker buy (long) volume over the last 12 hours, in USD
data[].short_volume_usd_12hnumberNoTaker sell (short) volume over the last 12 hours, in USD
data[].long_volume_usd_24hnumberNoTaker buy (long) volume over the last 24 hours, in USD
data[].short_volume_usd_24hnumberNoTaker sell (short) volume over the last 24 hours, in USD
data[].liquidation_usd_1hnumberNoTotal liquidation amount (last 1 hour), in USD
data[].long_liquidation_usd_1hnumberNoLong liquidation amount (last 1 hour), in USD
data[].short_liquidation_usd_1hnumberNoShort liquidation amount (last 1 hour), in USD
data[].liquidation_usd_4hnumberNoTotal liquidation amount (last 4 hours), in USD
data[].long_liquidation_usd_4hnumberNoLong liquidation amount (last 4 hours), in USD
data[].short_liquidation_usd_4hnumberNoShort liquidation amount (last 4 hours), in USD
data[].liquidation_usd_12hnumberNoTotal liquidation amount (last 12 hours), in USD
data[].long_liquidation_usd_12hnumberNoLong liquidation amount (last 12 hours), in USD
data[].short_liquidation_usd_12hnumberNoShort liquidation amount (last 12 hours), in USD
data[].liquidation_usd_24hnumberNoTotal liquidation amount (last 24 hours), in USD
data[].long_liquidation_usd_24hnumberNoLong liquidation amount (last 24 hours), in USD
data[].short_liquidation_usd_24hnumberNoShort liquidation amount (last 24 hours), in USD

API Plans

Only the API plans marked Yes in the table below can call this endpoint. For the price of each plan, see API Plans.

API PlanAccess
Hobbyist❌ No
Startup❌ No
Standard✅ Yes
Professional✅ Yes
Enterprise✅ Yes

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.

Build a coin leaderboard
Have AI write a Python function that lists the top 20 coins by open interest with their key metrics.
Screen for coins with unusual activity
Have AI write a script that finds coins whose open interest and price both change sharply.
Understand this endpoint
Have AI explain each group of fields and the parameters in plain language.

Want AI to query real-time data without writing code? Connect CoinGlass MCP in Claude or Cursor and ask in plain language, for example: “Which 10 coins currently have the largest futures open interest, and what are their funding rates?”

Use Cases

ScenarioDescription
Coin LeaderboardsRank coins by open interest, trading volume, 24-hour price change or liquidation amount to quickly see where the market's focus is.
Coin ScreeningCombine conditions on open interest change, price change and funding rate to screen for coins where leverage is building up or positioning is crowded.
Market Sentiment DashboardShow each coin's long/short ratio and long and short liquidation amounts to judge whether the market leans long or short.
Comparison by ExchangeUse exchange_list to include only some exchanges and compare a coin's open interest and trading on different platforms.

Related Endpoints

EndpointHow It Differs
Pair MarketsMarket data of a coin for each exchange and trading pair
Coin Price ChangeReturns only price changes and amplitudes, for all coins at once
Coin Open Interest by ExchangeBreakdown of a coin's open interest by exchange
Coin Funding Rate by ExchangeReal-time funding rates on each exchange
Liquidation Coin ListLiquidation amounts of each coin on an exchange

FAQ

Is 0.82 in price_change_percent_24h 0.82% or 82%?

0.82%. Fields whose names contain percent and the two average funding rate fields are already percentage values; *_ratio fields are plain ratios.

How is long_short_ratio calculated?

It is the taker buy volume divided by the taker sell volume in that period; for example, long_short_ratio_5m equals long_volume_usd_5m ÷ short_volume_usd_5m. A value above 1 means more taker buying.

What is the maximum number of coins I can get at once?

Up to 200 per page (per_page values above 200 are treated as 200). Results are sorted by open_interest_usd from highest to lowest; for more coins, increment page. When fewer results than per_page are returned, you have reached the last page; a page number beyond the end returns a successful response with an empty array. If you only care about a few coins, filter with symbol_list, e.g., BTC,ETH.

Which API plans can call this endpoint?

Standard, Professional and Enterprise can call it; Hobbyist and Startup cannot call this endpoint.

Learn More: Futures Coin Market Metrics

What Does the Ratio of Open Interest to Market Cap Indicate?

The higher open_interest_market_cap_ratio is, the more leveraged futures capital there is relative to the coin's market cap, and the more easily futures trading and liquidations can amplify price swings.

What Is the Difference Between OI-Weighted and Volume-Weighted Average Funding Rates?

The OI-weighted rate better reflects the funding rate that position holders actually bear; the volume-weighted rate leans toward actively traded markets. A large gap between the two means sentiment differs between the active markets and the markets with large open interest.

How Do I Get Data for a Single Exchange and Trading Pair?

Use Pair Markets and pass a coin to get its price, open interest, trading volume and funding rate for each trading pair on each exchange.

Query Params
string

Exchanges to include in the statistics; optional; separate multiple values with commas, e.g., Binance,OKX,Bybit. If omitted, empty or set to all (case-insensitive), all exchanges are included. Pass names as written in the response of the Supported Exchanges endpoint, with no spaces before or after commas.

int32
≤ 200
Defaults to 100

Number of coins per page; default 100, maximum 200; values above 200 are treated as 200.

int32
Defaults to 1

Page number, starting from 1; default 1. If the page number is beyond the end of the results, a successful response with an empty array is returned.

string

Return only the listed coins; optional; separate multiple values with commas, e.g., BTC,ETH. Coin symbols are matched exactly; pass them as written in the response of the Supported Coins endpoint, with no spaces before or after commas. If omitted, all coins are returned.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json