Exchange Data by ID

curl --request GET \
  --url https://api.coingecko.com/api/v3/exchanges/{id} \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "name": "Binance",
  "year_established": 2017,
  "country": "Cayman Islands",
  "description": "One of the world's largest cryptocurrency exchanges by trading volume.",
  "url": "https://www.binance.com/",
  "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
  "facebook_url": "https://www.facebook.com/binanceexchange",
  "reddit_url": "https://www.reddit.com/r/binance/",
  "telegram_url": "",
  "slack_url": "",
  "other_url_1": "https://medium.com/binanceexchange",
  "other_url_2": "https://steemit.com/@binanceexchange",
  "twitter_handle": "binance",
  "has_trading_incentive": false,
  "centralized": true,
  "public_notice": "",
  "alert_notice": "",
  "trust_score": 10,
  "trust_score_rank": 2,
  "coins": 435,
  "pairs": 1391,
  "trade_volume_24h_btc": 95073.68489926813,
  "tickers": [
    {
      "base": "USDC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false
      },
      "last": 1.00087,
      "volume": 2089887585,
      "converted_last": {
        "btc": 0.00001301,
        "eth": 0.00047417,
        "usd": 0.999569
      },
      "converted_volume": {
        "btc": 27187,
        "eth": 990971,
        "usd": 2088986570
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010999,
      "timestamp": "2026-05-26T10:21:17+00:00",
      "last_traded_at": "2026-05-26T10:21:17+00:00",
      "last_fetch_at": "2026-05-26T10:23:00+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/USDC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "usd-coin",
      "target_coin_id": "tether",
      "coin_mcap_usd": 76286248956.20789
    },
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false
      },
      "last": 76960,
      "volume": 9037.21995,
      "converted_last": {
        "btc": 1.000348,
        "eth": 36.491428,
        "usd": 76860
      },
      "converted_volume": {
        "btc": 9040,
        "eth": 329781,
        "usd": 694600292
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-26T10:21:39+00:00",
      "last_traded_at": "2026-05-26T10:21:39+00:00",
      "last_fetch_at": "2026-05-26T10:22:33+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "bitcoin",
      "target_coin_id": "tether",
      "coin_mcap_usd": 1536007329547.9153
    }
  ],
  "status_updates": [
    {
      "description": "Juventus and Paris Saint-Germain Fan Tokens on Binance Launchpool!",
      "category": "general",
      "created_at": "2020-12-14T11:18:49.085Z",
      "user": "Darc",
      "user_title": "Marketing",
      "pin": false,
      "project": {
        "type": "Market",
        "id": "binance",
        "name": "Binance",
        "image": {
          "thumb": "https://coin-images.coingecko.com/markets/images/52/thumb/binance.jpg?1706864274",
          "small": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
          "large": "https://coin-images.coingecko.com/markets/images/52/large/binance.jpg?1706864274"
        }
      }
    }
  ]
}

GET

exchanges

{id}

Exchange Data by ID

curl --request GET \
  --url https://api.coingecko.com/api/v3/exchanges/{id} \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "name": "Binance",
  "year_established": 2017,
  "country": "Cayman Islands",
  "description": "One of the world's largest cryptocurrency exchanges by trading volume.",
  "url": "https://www.binance.com/",
  "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
  "facebook_url": "https://www.facebook.com/binanceexchange",
  "reddit_url": "https://www.reddit.com/r/binance/",
  "telegram_url": "",
  "slack_url": "",
  "other_url_1": "https://medium.com/binanceexchange",
  "other_url_2": "https://steemit.com/@binanceexchange",
  "twitter_handle": "binance",
  "has_trading_incentive": false,
  "centralized": true,
  "public_notice": "",
  "alert_notice": "",
  "trust_score": 10,
  "trust_score_rank": 2,
  "coins": 435,
  "pairs": 1391,
  "trade_volume_24h_btc": 95073.68489926813,
  "tickers": [
    {
      "base": "USDC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false
      },
      "last": 1.00087,
      "volume": 2089887585,
      "converted_last": {
        "btc": 0.00001301,
        "eth": 0.00047417,
        "usd": 0.999569
      },
      "converted_volume": {
        "btc": 27187,
        "eth": 990971,
        "usd": 2088986570
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010999,
      "timestamp": "2026-05-26T10:21:17+00:00",
      "last_traded_at": "2026-05-26T10:21:17+00:00",
      "last_fetch_at": "2026-05-26T10:23:00+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/USDC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "usd-coin",
      "target_coin_id": "tether",
      "coin_mcap_usd": 76286248956.20789
    },
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false
      },
      "last": 76960,
      "volume": 9037.21995,
      "converted_last": {
        "btc": 1.000348,
        "eth": 36.491428,
        "usd": 76860
      },
      "converted_volume": {
        "btc": 9040,
        "eth": 329781,
        "usd": 694600292
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-26T10:21:39+00:00",
      "last_traded_at": "2026-05-26T10:21:39+00:00",
      "last_fetch_at": "2026-05-26T10:22:33+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "bitcoin",
      "target_coin_id": "tether",
      "coin_mcap_usd": 1536007329547.9153
    }
  ],
  "status_updates": [
    {
      "description": "Juventus and Paris Saint-Germain Fan Tokens on Binance Launchpool!",
      "category": "general",
      "created_at": "2020-12-14T11:18:49.085Z",
      "user": "Darc",
      "user_title": "Marketing",
      "pin": false,
      "project": {
        "type": "Market",
        "id": "binance",
        "name": "Binance",
        "image": {
          "thumb": "https://coin-images.coingecko.com/markets/images/52/thumb/binance.jpg?1706864274",
          "small": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
          "large": "https://coin-images.coingecko.com/markets/images/52/large/binance.jpg?1706864274"
        }
      }
    }
  ]
}

Notes

Exchange volume is provided in BTC. Use Exchange Rates to convert to other currencies.
Tickers are limited to 100 items. Use Exchange Tickers for more.
For derivatives exchanges (e.g. bitmex, binance_futures), use Derivatives Exchange Data instead.
When dex_pair_format=symbol, DEX pair base and target display as symbols (e.g. WETH, USDC) instead of contract addresses.

SDK Examples

const response = await client.exchanges.getID('binance');

console.log(JSON.stringify(response, null, 2));

response = client.exchanges.get_id("binance")

print(response.model_dump_json(indent=2))

Authorizations

x-cg-demo-api-key

string

header

required

Learn how to set up your API key

Path Parameters

string

default:binance

required

Exchange ID. *refers to /exchanges/list.

Query Parameters

dex_pair_format

enum<string>

Set to symbol to display DEX pair base and target as symbols. Default: contract_address

Available options:

contract_address,

symbol

Response

200 - application/json

Exchange data

name

string

required

Exchange name

year_established

number | null

required

Year the exchange was established

country

string | null

required

Country where the exchange is based

description

string

required

Exchange description

url

string

required

Exchange website URL

image

string

required

Exchange logo URL

facebook_url

string

required

Facebook URL

reddit_url

string

required

Reddit URL

telegram_url

string

required

Telegram URL

slack_url

string

required

Slack URL

other_url_1

string

required

Other URL 1

other_url_2

string

required

Other URL 2

twitter_handle

string

required

Twitter handle

has_trading_incentive

boolean

required

Whether the exchange has trading incentive

centralized

boolean

required

Whether the exchange is centralized

public_notice

string

required

Public notice

alert_notice

string

required

Alert notice

trust_score

number | null

required

Exchange trust score

trust_score_rank

number | null

required

Exchange trust score rank

coins

number

required

Number of coins listed

pairs

number

required

Number of trading pairs

trade_volume_24h_btc

number

required

Exchange 24h trading volume in BTC

tickers

object[]

required

Exchange tickers

Show child attributes

status_updates

object[]

required

Status updates

Show child attributes

Exchanges List with Data Exchange Tickers by ID

CoinGecko API

Onchain API

Exchange Data by ID

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples