Skip to main content
GET
/
exchanges
/
{id}
Exchange Data by ID
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/exchanges/{id} \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "name": "Binance",
  "year_established": 2017,
  "country": "Cayman Islands",
  "description": "",
  "url": "https://www.binance.com/",
  "image": "https://assets.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": 9,
  "trust_score_rank": 6,
  "trade_volume_24h_btc": 207319.133772613,
  "coins": 384,
  "pairs": 1281,
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false,
        "logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"
      },
      "last": 69476,
      "volume": 20242.03975,
      "cost_to_move_up_usd": 19320706.3958517,
      "cost_to_move_down_usd": 16360235.3694131,
      "converted_last": {
        "btc": 1.000205,
        "eth": 20.291404,
        "usd": 69498
      },
      "converted_volume": {
        "btc": 20249,
        "eth": 410802,
        "usd": 1406996874
      },
      "trust_score": "green",
      "bid_ask_spread_percentage": 0.010014,
      "timestamp": "2024-04-08T04:02:01+00:00",
      "last_traded_at": "2024-04-08T04:02:01+00:00",
      "last_fetch_at": "2024-04-08T04:03:00+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"
    }
  ]
}

​
Notice

  • Please note that the trade_volume_24h_btc_normalized data field will no longer be supported by our API starting on June 16, 2025. Please refer to changelog for more details.

​
Note

  • The exchange volume in the response is provided in BTC. To convert it to other currencies, please use /exchange_rates endpoint.
  • For derivatives (e.g. bitmex, binance_futures), to get derivatives exchanges data, please go to /derivatives/exchange/{id} endpoint.
  • Tickers are limited to 100 items, to get more tickers, please go to /exchanges/{id}/tickers endpoint.
  • When dex_pair_format=symbol, the DEX pair base and target are displayed in symbol format (e.g. WETH, USDC) instead of as contract addresses.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Authorizations

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

Path Parameters

​
id
string
default:binance
required

exchange ID *refers to /exchanges/list.

Example:

"binance"

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

Get exchange volume in BTC and top 100 tickers only

​
name
string

exchange name

​
year_established
number

exchange established year

​
country
string

exchange incorporated country

​
description
string

exchange description

​
url
string

exchange website url

​
image
string

exchange image url

​
facebook_url
string

exchange facebook url

​
reddit_url
string

exchange reddit url

​
telegram_url
string

exchange telegram url

​
slack_url
string

exchange slack url

​
other_url_1
string
​
other_url_2
string
​
twitter_handle
string

exchange twitter handle

​
has_trading_incentive
boolean

exchange trading incentive

​
centralized
boolean

exchange type (true for centralized, false for decentralized)

​
public_notice
string

public notice for exchange

​
alert_notice
string

alert notice for exchange

​
trust_score
number

exchange trust score

​
trust_score_rank
number

exchange trust score rank

​
trade_volume_24h_btc
number
​
coins
number

number of coins listed on the exchange

​
pairs
number

number of trading pairs on the exchange

​
tickers
object[]