Derivatives Exchange Data by ID
curl --request GET \
--url https://api.coingecko.com/api/v3/derivatives/exchanges/{id} \
--header 'x-cg-demo-api-key: <api-key>'{
"name": "Binance (Futures)",
"open_interest_btc": 331945.73,
"trade_volume_24h_btc": "587332.45",
"number_of_perpetual_pairs": 592,
"number_of_futures_pairs": 72,
"image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452",
"year_established": 2019,
"country": "Cayman Islands",
"description": "",
"url": "https://www.binance.com/",
"tickers": [
{
"symbol": "0GUSDT",
"base": "0G",
"target": "USDT",
"coin_id": "zero-gravity",
"target_coin_id": "tether",
"rwa_id": null,
"trade_url": "https://www.binance.com/en/futures/0GUSDT",
"contract_type": "perpetual",
"last": 0.473,
"h24_percentage_change": -1.149,
"index": 0.47388788,
"index_basis_percentage": -0.066,
"bid_ask_spread": 0.0004225649693639931,
"funding_rate": 0.005,
"open_interest_usd": 7505441.41551142,
"h24_volume": 6822128,
"converted_volume": {
"btc": "42.0799463192663717990920674226785386061670893822933102624",
"eth": "1536.67707296907453613610493674728740267430011541374571065838147892993088",
"usd": "3222911.4917378246159226528"
},
"converted_last": {
"btc": "0.0000061681554962419895667586517612508206539318947668958",
"eth": "0.00022524893595797008442763092934452232539088978034621245902427827196",
"usd": "0.4724202612055687926"
},
"last_traded": 1779809107,
"expired_at": null
},
{
"symbol": "1000000BOBUSDT",
"base": "1000000BOB",
"target": "USDT",
"coin_id": "build-on-bnb",
"target_coin_id": "tether",
"rwa_id": null,
"trade_url": "https://www.binance.com/en/futures/1000000BOBUSDT",
"contract_type": "perpetual",
"last": 0.015,
"h24_percentage_change": -3.331,
"index": 0.01540057,
"index_basis_percentage": 0.134,
"bid_ask_spread": 0.001298701298701358,
"funding_rate": 0.005,
"open_interest_usd": 916291.34908113,
"h24_volume": 44830706,
"converted_volume": {
"btc": "8.975935927077560026865126277039614163512381271518795395788",
"eth": "327.26598326618858627284207444108921232850344104115627132937452733698970504",
"usd": "688649.790093212658495595932"
},
"converted_last": {
"btc": "0.000000200218482552506757909748873395828612726116364786198",
"eth": "0.00000730004080832875097422829063724959433671429223178319501212794925284",
"usd": "0.015361118562201823422"
},
"last_traded": 1779808948,
"expired_at": null
},
{
"symbol": "AAPLUSDT",
"base": "AAPL",
"target": "USDT",
"coin_id": null,
"target_coin_id": "tether",
"rwa_id": "apple",
"trade_url": "https://www.binance.com/en/futures/AAPLUSDT",
"contract_type": "perpetual",
"last": 350.92,
"h24_percentage_change": -0.598,
"index": 350.86093715,
"index_basis_percentage": -0.017,
"bid_ask_spread": 0.0000284973354992669,
"funding_rate": 0,
"open_interest_usd": 51127238.814655185,
"h24_volume": 276243.07,
"converted_volume": {
"btc": "1507.439847349607",
"eth": "53926.42549147525",
"usd": "97197797.07816656"
},
"converted_last": {
"btc": "0.005437359134480062",
"eth": "0.1945134611848482",
"usd": "350.5939760870193"
},
"last_traded": 1794971743,
"expired_at": null
}
]
}Derivatives Exchange Data by ID
To query the derivatives exchange’s related data (name, open interest, trade volume, …) based on the exchange’s ID
GET
/
derivatives
/
exchanges
/
{id}
Derivatives Exchange Data by ID
curl --request GET \
--url https://api.coingecko.com/api/v3/derivatives/exchanges/{id} \
--header 'x-cg-demo-api-key: <api-key>'{
"name": "Binance (Futures)",
"open_interest_btc": 331945.73,
"trade_volume_24h_btc": "587332.45",
"number_of_perpetual_pairs": 592,
"number_of_futures_pairs": 72,
"image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452",
"year_established": 2019,
"country": "Cayman Islands",
"description": "",
"url": "https://www.binance.com/",
"tickers": [
{
"symbol": "0GUSDT",
"base": "0G",
"target": "USDT",
"coin_id": "zero-gravity",
"target_coin_id": "tether",
"rwa_id": null,
"trade_url": "https://www.binance.com/en/futures/0GUSDT",
"contract_type": "perpetual",
"last": 0.473,
"h24_percentage_change": -1.149,
"index": 0.47388788,
"index_basis_percentage": -0.066,
"bid_ask_spread": 0.0004225649693639931,
"funding_rate": 0.005,
"open_interest_usd": 7505441.41551142,
"h24_volume": 6822128,
"converted_volume": {
"btc": "42.0799463192663717990920674226785386061670893822933102624",
"eth": "1536.67707296907453613610493674728740267430011541374571065838147892993088",
"usd": "3222911.4917378246159226528"
},
"converted_last": {
"btc": "0.0000061681554962419895667586517612508206539318947668958",
"eth": "0.00022524893595797008442763092934452232539088978034621245902427827196",
"usd": "0.4724202612055687926"
},
"last_traded": 1779809107,
"expired_at": null
},
{
"symbol": "1000000BOBUSDT",
"base": "1000000BOB",
"target": "USDT",
"coin_id": "build-on-bnb",
"target_coin_id": "tether",
"rwa_id": null,
"trade_url": "https://www.binance.com/en/futures/1000000BOBUSDT",
"contract_type": "perpetual",
"last": 0.015,
"h24_percentage_change": -3.331,
"index": 0.01540057,
"index_basis_percentage": 0.134,
"bid_ask_spread": 0.001298701298701358,
"funding_rate": 0.005,
"open_interest_usd": 916291.34908113,
"h24_volume": 44830706,
"converted_volume": {
"btc": "8.975935927077560026865126277039614163512381271518795395788",
"eth": "327.26598326618858627284207444108921232850344104115627132937452733698970504",
"usd": "688649.790093212658495595932"
},
"converted_last": {
"btc": "0.000000200218482552506757909748873395828612726116364786198",
"eth": "0.00000730004080832875097422829063724959433671429223178319501212794925284",
"usd": "0.015361118562201823422"
},
"last_traded": 1779808948,
"expired_at": null
},
{
"symbol": "AAPLUSDT",
"base": "AAPL",
"target": "USDT",
"coin_id": null,
"target_coin_id": "tether",
"rwa_id": "apple",
"trade_url": "https://www.binance.com/en/futures/AAPLUSDT",
"contract_type": "perpetual",
"last": 350.92,
"h24_percentage_change": -0.598,
"index": 350.86093715,
"index_basis_percentage": -0.017,
"bid_ask_spread": 0.0000284973354992669,
"funding_rate": 0,
"open_interest_usd": 51127238.814655185,
"h24_volume": 276243.07,
"converted_volume": {
"btc": "1507.439847349607",
"eth": "53926.42549147525",
"usd": "97197797.07816656"
},
"converted_last": {
"btc": "0.005437359134480062",
"eth": "0.1945134611848482",
"usd": "350.5939760870193"
},
"last_traded": 1794971743,
"expired_at": null
}
]
}Notes
- Tickers are not filtered by last trade time, unlike Derivatives Tickers List, which only includes tickers traded in the last 24 hours. Check
last_tradedto spot tickers that haven’t traded recently. - Tickers based on an RWA, such as
AAPLUSDT, return the RWA ID inrwa_id(e.g.apple) andnullincoin_id. All other tickers returnnullinrwa_id.
Use
include_tickers=all to include all tickers, unexpired for unexpired tickers only, or leave blank to omit tickers.SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.derivatives.exchanges.getID('binance_futures');
console.log(JSON.stringify(response, null, 2));
response = client.derivatives.exchanges.get_id("binance_futures")
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Path Parameters
Derivative exchange ID.
*refers to /derivatives/exchanges/list.
Query Parameters
Response
200 - application/json
Derivative exchange data
Derivative tickers data, available when include_tickers is specified
Hide child attributes
Hide child attributes
Was this page helpful?

