CoinGecko API endpoint
Returns profile stats and market rows from a CoinGecko exchange page. This endpoint supports the documented `vs_currency` enum.
/coingecko/exchange/{id}Returns exchange profile stats and market rows from a CoinGecko exchange page such as /en/exchanges/binance.
Path parameters:
id: CoinGecko exchange id, for example binance.Query parameters:
limit: market rows to return. Default 100, max 100.vs_currency: quote currency. Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats.Notable response behavior:
markets includes rank, coin identity, pair, price, spread percent, +2% depth, -2% depth, 24h volume, volume percent, and last updated text when present.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| rank | 20 | 1 to 20, median 10 |
| coin_id | 20 | |
| coin_symbol | 20 | “USDC” and 14 other values |
| coin_url | 20 | coingecko.com |
| pair | 20 | “USDC/USDT” and 19 other values |
| price | 20 | 0.08 to 83,125.23, median 7.55 |
| spread_percent | 20 | 0.01 to 0.05, median 0.01 |
| depth_plus_2_percent | 20 | 305,755 to 26,594,187, median 2,050,661 |
| depth_minus_2_percent | 20 | 189,015 to 40,676,925, median 1,984,538 |
| volume_24h | 20 | 62,530,914 to 4,413,896,453, median 133,476,542 |
| volume_percent | 20 | 0.52 to 36.92, median 1.12 |
| last_updated | 20 | Recently in all 20 |
| coin_name | 16 | “Bitcoin” and 10 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | CoinGecko exchange id such as binance | binance | |
| limit | integer | No | Rows to return, default 100, max 100 | ||
| vs_currency | string | No | Quote currency Allowed values: btc, eth, ltc, bch, bnb, eos, xrp, xlm, link, dot, yfi, sol, usd, aed, ars, aud, bdt, bhd, bmd, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, gel, hkd, huf, idr, ils, inr, jpy, krw, kwd, lkr, mmk, mxn, myr, ngn, nok, nzd, php, pkr, pln, rub, sar, sek, sgd, thb, try, twd, uah, vef, vnd, zar, xdr, xag, xau, bits, sats. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/coingecko/exchange/binance?limit=10&vs_currency=btc" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "binance",
"name": "Binance",
"kind": "spot",
"trust_score": 10,
"limit": 100,
"vs_currency": "usd",
"source_url": "https://www.coingecko.com/en/exchanges/binance",
"fetched_at": "2026-05-24T00:00:00Z",
"markets": [
{
"rank": 1,
"coin_id": "bitcoin",
"coin_name": "Bitcoin",
"pair": "BTC/USDT",
"price": 76535.94,
"spread_percent": 0.01
}
]
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.exchangeDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.ExchangeDetailResponse | No | ||||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.id | string | No | binance | CoinGecko exchange id. | ||
| data.kind | string | No | spot | Exchange table kind. Currently always `spot`. | ||
| data.limit | integer | No | 100 | Maximum number of markets returned. | ||
| data.markets | array | No | Trading pairs listed on the exchange, one row per pair. | |||
| data.markets[].coin_id | string | No | bitcoin | CoinGecko id of the base coin. | ||
| data.markets[].coin_name | string | No | Bitcoin | Name of the base coin. | ||
| data.markets[].coin_symbol | string | No | BTC | Ticker symbol of the base coin. | ||
| data.markets[].coin_url | string | No | https://www.coingecko.com/en/coins/bitcoin | Link to the base coin page on CoinGecko. | ||
| data.markets[].depth_minus_2_percent | number | No | 1100000 | Order book depth within 2% below the price. | ||
| data.markets[].depth_plus_2_percent | number | No | 1200000 | Order book depth within 2% above the price. | ||
| data.markets[].last_updated | string | No | Recently | When the pair was last updated, as CoinGecko words it, for example `Recently`. | ||
| data.markets[].pair | string | No | BTC/USDT | Trading pair, for example `BTC/USDT`. | ||
| data.markets[].price | number | No | 76535.94 | Last price of the pair. | ||
| data.markets[].rank | integer | No | 1 | Position of the pair in the exchange's market table. | ||
| data.markets[].spread_percent | number | No | 0.01 | Bid-ask spread of the pair, in percent. | ||
| data.markets[].volume_24h | number | No | 2100000000 | Trading volume of the pair over the last 24 hours. | ||
| data.markets[].volume_percent | number | No | 8.5 | Share of the exchange's trading volume that this pair accounts for, in percent. | ||
| data.name | string | No | Binance | Name of the exchange. | ||
| data.source_url | string | No | https://www.coingecko.com/en/exchanges/binance | URL the data was read from. | ||
| data.trust_score | number | No | 10 | CoinGecko trust score of the exchange, shown on a scale up to 10. | ||
| data.volume_24h | number | No | 23789315893 | Trading volume over the last 24 hours. | ||
| data.volume_24h_text | string | No | $23,789,315,893 | 24-hour trading volume as CoinGecko displays it, for example `$23,789,315,893`. | ||
| data.vs_currency | string | No | usd | Currency code from the request's vs_currency parameter. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/coingecko/exchange/binance?limit=10&vs_currency=btc" \
-H "x-api-key: $CRAWLORA_API_KEY"