Docs menu
CoinGecko API endpoint
CoinGecko Coin API
Returns CoinGecko profile, market stats, links, and categories for one coin id. This endpoint supports the documented `vs_currency` enum and is not intended for real-time trading.
GETapiKey2 credits/requestCoinGeckocoingecko.coinResponseDoc
CoinGecko/coingecko/coin/{id}Endpoint facts
- Method
- GET
- API path
- /coingecko/coin/{id}
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- CoinGecko
- Response schema
- #/definitions/coingecko.coinResponseDoc
How this endpoint behaves
Returns profile and market statistics from a CoinGecko coin page.
Path parameters:
id: CoinGecko coin slug/API id, for examplebitcoin.
Query parameters:
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:
- The response includes identity fields, rank, price, change metrics, market statistics, supply statistics, links, categories,
source_url, andfetched_atwhen present upstream. - Challenge pages, malformed HTML, and pages missing expected coin-profile markers return an upstream error.
Live monitoring
- Monitored request
- GET /coingecko/coin/bitcoin?vs_currency=usd
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.35 s
Sampled response
- Request, 14 Oct 2026
- GET /coingecko/coin/bitcoin?vs_currency=usd
- Fields returned with a value
- 20
| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| symbol | Has a value | “BTC” |
| name | Has a value | “Bitcoin” |
| rank | Has a value | 1 |
| price | Has a value | 83,119.51 |
| change_1h_percent | Has a value | 0 |
| change_24h_percent | Has a value | 0.8 |
| change_7d_percent | Has a value | 2.8 |
| market_cap | Has a value | 4.07 |
| fully_diluted_valuation | Has a value | 1,671,000,000,000 |
| volume_24h | Has a value | 32,204,000,000 |
| circulating_supply | Has a value | 20,097,000 |
| total_supply | Has a value | 20,098,000 |
| max_supply | Has a value | 21,000,000 |
| links.github | Has a value | github.com |
| links.reddit | Has a value | reddit.com |
| links.twitter | Has a value | twitter.com |
| links.website | Has a value | coingecko.app.link |
| links.whitepaper | Has a value | bitcoin.org |
| categories | Has a value | 8 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | CoinGecko coin id such as bitcoin | bitcoin | |
| 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 example
curl -X GET "https://api.crawlora.net/api/v1/coingecko/coin/bitcoin?vs_currency=btc" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "ok",
"data": {
"id": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin",
"rank": 1,
"price": 76535.94,
"change_24h_percent": 1.5,
"market_cap": 1533816836729,
"volume_24h": 26813530873,
"links": {
"website": "https://bitcoin.org",
"github": "https://github.com/bitcoin/bitcoin"
},
"categories": [
"Smart Contract Platform"
],
"source_url": "https://www.coingecko.com/en/coins/bitcoin",
"fetched_at": "2026-05-24T00:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.coinResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.CoinResponse | No | ||||
| data.categories | array | No | Names of the CoinGecko categories the coin belongs to. | |||
| data.change_1h_percent | number | No | -0.1 | Price change over the last hour, in percent. | ||
| data.change_24h_percent | number | No | 1.5 | Price change over the last 24 hours, in percent. | ||
| data.change_7d_percent | number | No | -1.9 | Price change over the last 7 days, in percent. | ||
| data.circulating_supply | number | No | 20033818 | Number of coins currently in circulation. | ||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.fully_diluted_valuation | number | No | 1533816836729 | Fully diluted valuation. | ||
| data.id | string | No | bitcoin | CoinGecko coin id. | ||
| data.links | object | No | Outbound links for the coin, keyed by kind: `website`, `whitepaper`, `github`, `twitter` or `reddit`. Only kinds CoinGecko lists are present. | |||
| data.market_cap | number | No | 1533816836729 | Market capitalisation of the coin. | ||
| data.max_supply | number | No | 21000000 | Maximum number of coins that can ever exist. | ||
| data.name | string | No | Bitcoin | Name of the coin. | ||
| data.price | number | No | 76535.94 | Current price of the coin. | ||
| data.rank | integer | No | 1 | Market cap rank of the coin. | ||
| data.source_url | string | No | https://www.coingecko.com/en/coins/bitcoin | URL the data was read from. | ||
| data.symbol | string | No | BTC | Ticker symbol of the coin. | ||
| data.total_supply | number | No | 20033818 | Total number of coins that exist now. | ||
| data.volume_24h | number | No | 26813530873 | Trading volume over the last 24 hours. | ||
| msg | string | No | OK |
Failure responses
| 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 |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/coingecko/coin/bitcoin?vs_currency=btc" \
-H "x-api-key: $CRAWLORA_API_KEY"