Derivatives Exchange Data by ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/derivatives/exchanges/{id} \
  --header 'x-cg-pro-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",
      "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",
      "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
    }
  ]
}

GET

derivatives

exchanges

{id}

Derivatives Exchange Data by ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/derivatives/exchanges/{id} \
  --header 'x-cg-pro-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",
      "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",
      "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
    }
  ]
}

Use include_tickers=all to include all tickers, unexpired for unexpired tickers only, or leave blank to omit tickers.

SDK Examples

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

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

string

default:binance_futures

required

Derivative exchange ID. *refers to /derivatives/exchanges/list.

Query Parameters

include_tickers

enum<string>

Include tickers data. Default: tickers data is not included.

Available options:

all,

unexpired

Response

200 - application/json

Derivative exchange data

name

string

required

Derivatives exchange name

open_interest_btc

number | null

required

Derivatives exchange open interest in BTC

trade_volume_24h_btc

string

required

Derivatives exchange trade volume in BTC in 24 hours

number_of_perpetual_pairs

integer

required

Number of perpetual pairs in the derivatives exchange

number_of_futures_pairs

integer

required

Number of futures pairs in the derivatives exchange

image

string

required

Derivatives exchange image URL

year_established

integer | null

required

Derivatives exchange established year

country

string | null

required

Derivatives exchange incorporated country

description

string

required

Derivatives exchange description

url

string

required

Derivatives exchange website URL

tickers

object[]

Derivative tickers data, available when include_tickers is specified

Hide child attributes

tickers.symbol

string

required

Derivative ticker symbol

tickers.base

string

required

Derivative base asset

tickers.target

string

required

Derivative target asset

tickers.coin_id

string

required

Derivative base asset coin ID

tickers.target_coin_id

string

required

Derivative target asset coin ID

tickers.trade_url

string

required

Derivative trade URL

tickers.contract_type

string

required

Derivative contract type

tickers.last

number

required

Derivative last price

tickers.h24_percentage_change

number

required

Derivative price percentage change in 24 hours

tickers.index

number

required

Derivative underlying asset price

tickers.index_basis_percentage

number

required

Difference of derivative price and index price in percentage

tickers.bid_ask_spread

number

required

Derivative bid-ask spread

tickers.funding_rate

number

required

Derivative funding rate

tickers.open_interest_usd

number

required

Derivative open interest in USD

tickers.h24_volume

number

required

Derivative volume in 24 hours

tickers.converted_volume

object

required

Derivative converted volume

Hide child attributes

tickers.converted_volume.btc

string

tickers.converted_volume.eth

string

tickers.converted_volume.usd

string

tickers.converted_last

object

required

Derivative converted last price

Hide child attributes

tickers.converted_last.btc

string

tickers.converted_last.eth

string

tickers.converted_last.usd

string

tickers.last_traded

number

required

Derivative last traded time in UNIX timestamp

tickers.expired_at

number | null

required

Derivative expiry time in UNIX timestamp

CoinGecko API

Onchain API

Derivatives Exchange Data by ID

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

SDK Examples