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": 280210.26,
  "trade_volume_24h_btc": "568502.31",
  "number_of_perpetual_pairs": 330,
  "number_of_futures_pairs": 44,
  "image": "https://assets.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452",
  "year_established": 2019,
  "country": null,
  "description": "",
  "url": "https://www.binance.com/",
  "tickers": {
    "tickers": [
      {
        "symbol": "1000BONKUSDT",
        "base": "1000BONK",
        "target": "USDT",
        "trade_url": "https://www.binance.com/en/futuresng/1000BONKUSDT",
        "contract_type": "perpetual",
        "last": 0.023,
        "h24_percentage_change": -0.811,
        "index": 0.0229866,
        "index_basis_percentage": -0.071,
        "bid_ask_spread": 0.000217533173808922,
        "funding_rate": 0.005,
        "open_interest_usd": 28102263.9997715,
        "h24_volume": 2679284723,
        "converted_volume": {
          "btc": "888.799603175094638929930629459045946",
          "eth": "18029.8066338945133622149580216234476206402026327668",
          "usd": "61648664.9602525617243462802989936852339753270611794"
        },
        "converted_last": {
          "btc": "0.000000331730179904099217651505502",
          "eth": "0.0000067293358108303271067525726423602078742716",
          "usd": "0.0230093742673322299700755918127159362875878"
        },
        "last_traded": 1712550723,
        "expired_at": null
      }
    ]
  }
}

​
Tips

  • For include_tickers param, you may change the value to either all to include all the tickers or unexpired to include unexpired tickers in the responses. You may leave it blank to omit the tickers data.

​
Note

  • Cache / Update Frequency: every 30 seconds for all the API plans.

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
id
string
default:binance_futures
required

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

Example:

"binance_futures"

Query Parameters

​
include_tickers
enum<string>

include tickers data

Available options:
all,
unexpired

Response

200 - application/json

Get derivative exchange data

​
name
string

derivatives exchange name

​
open_interest_btc
number

derivatives exchange open interest in BTC

​
trade_volume_24h_btc
string

derivatives exchange trade volume in BTC in 24 hours

​
number_of_perpetual_pairs
number

number of perpetual pairs in the derivatives exchange

​
number_of_futures_pairs
number

number of futures pairs in the derivatives exchange

​
image
string

derivatives exchange image url

​
year_established
number | null

derivatives exchange established year

​
country
string | null

derivatives exchange incorporated country

​
description
string

derivatives exchange description

​
url
string

derivatives exchange website url

​
tickers
object[]