Pair Markets

Get real-time market data for each futures trading pair of a coin on each exchange: price, index price, 24-hour trading volume, long/short volume, open interest, liquidation amount and funding rate. Useful for comparing the same coin's market conditions across exchanges.

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

Available on all API plans: Hobbyist Startup Standard Professional Enterprise

Response Data

data is an array; each element is one futures trading pair of the coin on one exchange. As of 2026-10-20, symbol=BTC returns 74 trading pairs; the example on the right keeps only the first 2.

📘

Percentages and ratios

Fields whose names contain percent, as well as funding_rate, are in %: 0.67 means 0.67%, so there is no need to multiply by 100. open_interest_volume_radio is a plain ratio, not a percentage.

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 trading pairs; each element is one futures trading pair on one exchange
data[].instrument_idstringYesFutures trading pair, in the exchange's native format
data[].exchange_namestringYesExchange name
data[].symbolstringYesCoin pair in base/quote format, e.g., BTC/USDT
data[].current_pricenumberYesCurrent price, in the quote asset
data[].index_pricenumberNoIndex price, in the quote asset
data[].price_change_percent_24hnumberYes24-hour price change, in %
data[].volume_usdnumberYes24-hour trading volume, in USD
data[].volume_usd_change_percent_24hnumberNo24-hour change in trading volume, in %; not returned for some trading pairs
data[].long_volume_usdnumberYesValue of long (taker buy) trades, in USD
data[].short_volume_usdnumberYesValue of short (taker sell) trades, in USD
data[].long_volume_quantityintegerYesNumber of long (taker buy) trades, counted in trades, not a quantity of coins
data[].short_volume_quantityintegerYesNumber of short (taker sell) trades, counted in trades, not a quantity of coins
data[].open_interest_quantitynumberYesOpen interest quantity, in number of coins
data[].open_interest_usdnumberYesOpen interest value, in USD
data[].open_interest_change_percent_24hnumberNo24-hour change in open interest, in %; not returned for some trading pairs
data[].long_liquidation_usd_24hnumberNoLong liquidation amount over the past 24 hours, in USD; not returned for trading pairs without liquidation data
data[].short_liquidation_usd_24hnumberNoShort liquidation amount over the past 24 hours, in USD; not returned for trading pairs without liquidation data
data[].funding_ratenumberNoCurrent funding rate, in % (0.01 means 0.01%); not returned for instruments without a funding rate, such as delivery contracts
data[].next_funding_timeinteger (int64)NoNext funding rate settlement time, timestamp in milliseconds (UTC)
data[].open_interest_volume_radionumberYesRatio of open interest to trading volume, a plain ratio. The field name is spelled radio; read it exactly as spelled
data[].oi_vol_ratio_change_percent_24hnumberNo24-hour change in the above ratio, in %; not returned for some trading pairs

API Plans

All API plans can call this endpoint. For the price of each plan, see API Plans.

API PlanAccess
Hobbyist✅ Yes
Startup✅ Yes
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.

Compare exchanges
Have AI write a Python function that compares BTC's trading volume, open interest and funding rates across exchanges.
Monitor basis and funding rates
Have AI write a script that finds trading pairs whose price deviates widely from the index price or whose funding rate is high.
Understand this endpoint
Have AI explain each field and the common pitfalls in plain language.

This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.

Use Cases

ScenarioDescription
Exchange Share ComparisonCompare the same coin's trading volume and open interest across exchanges to see where liquidity is concentrated.
Funding Rate ComparisonCompare the current funding rates and next settlement times of trading pairs across exchanges to look for rate differences.
Price Deviation MonitoringCompare current_price with index_price to find trading pairs that deviate widely from the index.
Long/Short Volume and Liquidation AnalysisUse long/short trading volume, trade counts and 24-hour long/short liquidation amounts to judge the relative strength of longs and shorts in a single market.

Related Endpoints

EndpointHow It Differs
Coin MarketsMarket metrics summarized by coin, not broken down by trading pair
Supported Exchanges and PairsContract rules for trading pairs (leverage, settlement interval, etc.)
Pair Price OHLC HistoryHistorical open, high, low and close prices and trading volume of a single trading pair
Coin Funding Rate by ExchangeDetailed list of funding rates on each exchange
Spot Pair MarketsTrading pair market data for the spot market

FAQ

Should symbol be a coin or a trading pair?

A coin, e.g., BTC; the endpoint returns all of that coin's futures trading pairs on each exchange. For the coins you can query, see the Supported Coins endpoint.

Is long_volume_quantity a quantity of coins?

No. long_volume_quantity and short_volume_quantity are the numbers of taker buy and taker sell trades; for trade value, see long_volume_usd and short_volume_usd.

How much is a funding_rate of 0.01?

It is 0.01%. In this endpoint, funding_rate and the fields whose names contain percent are already percentage values, so there is no need to multiply by 100.

Why are some fields missing for some trading pairs?

Not every trading pair has index_price, funding_rate, next_funding_time, the long/short liquidation amounts, or the three 24-hour change fields volume_usd_change_percent_24h, open_interest_change_percent_24h and oi_vol_ratio_change_percent_24h; for example, delivery contracts have no funding rate. Check whether a field exists before reading it, and do not treat a missing value as 0.

Learn More: Futures Trading Pair Market Data

What Is the Difference Between the Index Price and the Latest Price?

The latest price is the trading pair's last traded price; the index price is usually derived by weighting prices from multiple spot markets and is used to calculate funding rates and liquidation prices. A large deviation between the two often indicates that sentiment in the futures market is overheated or too cold.

What Does the Ratio of Open Interest to Trading Volume Indicate?

A high open_interest_volume_radio means there is more open interest relative to trading volume, so capital leans toward holding positions; a low ratio means frequent turnover and more active short-term capital.

How Do I View This Trading Pair's Price History?

Use Pair Price OHLC History and pass the exchange and the instrument_id to get its historical open, high, low and close prices.

Query Params
string
required
Defaults to BTC

Coin symbol, e.g., BTC, ETH, SOL. For the coins you can query, see the Supported Coins endpoint.

Responses

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