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

Hide child attributes

tickers.base

string

Ticker base currency

tickers.target

string

Ticker target currency

tickers.market

object

Exchange information

Hide child attributes

tickers.market.name

string

Exchange name

tickers.market.identifier

string

Exchange identifier

tickers.market.has_trading_incentive

boolean

Exchange trading incentive

tickers.last

number

Last price

tickers.volume

number

Trading volume

tickers.converted_last

object

Converted last price

Hide child attributes

tickers.converted_last.btc

number

tickers.converted_last.eth

number

tickers.converted_last.usd

number

tickers.converted_volume

object

Converted trading volume

Hide child attributes

tickers.converted_volume.btc

number

tickers.converted_volume.eth

number

tickers.converted_volume.usd

number

tickers.trust_score

string | null

Trust score

tickers.bid_ask_spread_percentage

number

Bid-ask spread percentage

tickers.timestamp

string

Ticker timestamp

tickers.last_traded_at

string

Last traded timestamp

tickers.last_fetch_at

string

Last fetch timestamp

tickers.is_anomaly

boolean

Whether ticker is anomalous

tickers.is_stale

boolean

Whether ticker is stale

tickers.trade_url

string

Trade URL

tickers.token_info_url

string | null

Token info URL

tickers.coin_id

string

Base currency coin ID

tickers.target_coin_id

string

Target currency coin ID

tickers.coin_mcap_usd

number

Coin market cap in USD

status_updates

object[]

required

Status updates

Hide child attributes

status_updates.description

string

Status update description

status_updates.category

string

Status update category

status_updates.created_at

string

Status update creation time

status_updates.user

string

Status update user

status_updates.user_title

string

Status update user title

status_updates.pin

boolean

Whether status update is pinned

status_updates.project

object

Project information

Hide child attributes

status_updates.project.type

string

Project type

status_updates.project.id

string

Project ID

status_updates.project.name

string

Project name

status_updates.project.image

object

Project image URLs

Hide child attributes

status_updates.project.image.thumb

string

status_updates.project.image.small

string

status_updates.project.image.large

string

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