Docs menu
CoinGecko API endpoint
CoinGecko Global API
Returns CoinGecko's global crypto market snapshot: total market cap in USD with its 24-hour and 1-year change, Bitcoin market cap, Bitcoin and Ethereum dominance, stablecoin market cap and share, and the number of coins, exchanges and categories tracked. Takes no parameters.
GETapiKey2 credits/requestCoinGeckocoingecko.globalResponseDoc
CoinGecko/coingecko/globalEndpoint facts
- Method
- GET
- API path
- /coingecko/global
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- CoinGecko
- Response schema
- #/definitions/coingecko.globalResponseDoc
How this endpoint behaves
Returns global market snapshot metrics from CoinGecko.
Path parameters: none.
Query parameters: none.
Notable response behavior:
- Returns market cap, dominance, stablecoin share, tracked-count metrics when present, plus
source_urlandfetched_at. - Challenge pages, empty bodies, and pages without parsable global market markers return upstream errors.
Live monitoring
- Monitored request
- GET /coingecko/global
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.31 s
Sampled response
- Request, 14 Oct 2026
- GET /coingecko/global
- Fields returned with a value
- 8
| Field | In the sample | Value in the sample |
|---|---|---|
| market_cap_usd | Has a value | 2,910,000,000,000 |
| market_cap_change_24h_percent | Has a value | 0.21 |
| market_cap_change_1y_percent | Has a value | -28.34 |
| bitcoin_market_cap_usd | Has a value | 1,680,000,000,000 |
| bitcoin_dominance_percent | Has a value | 57.6 |
| ethereum_dominance_percent | Has a value | 10.6 |
| stablecoin_market_cap_usd | Has a value | 307,000,000,000 |
| stablecoin_share_percent | Has a value | 10.54 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/coingecko/global" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"market_cap_usd": 2670000000000,
"market_cap_change_24h_percent": 1.2,
"market_cap_change_1y_percent": 68.4,
"bitcoin_market_cap_usd": 1350000000000,
"bitcoin_dominance_percent": 50.6,
"ethereum_dominance_percent": 17.2,
"stablecoin_market_cap_usd": 161000000000,
"stablecoin_share_percent": 6.03,
"coins_tracked": 17677,
"exchanges_tracked": 1233,
"categories_tracked": 308,
"source_url": "https://www.coingecko.com/en/charts",
"fetched_at": "2026-05-24T00:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.globalResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.GlobalResponse | No | ||||
| data.bitcoin_dominance_percent | number | No | 50.6 | Bitcoin share of the total crypto market capitalisation, in percent. | ||
| data.bitcoin_market_cap_usd | number | No | 1350000000000 | Bitcoin market capitalisation, in US dollars. | ||
| data.categories_tracked | integer | No | 308 | Number of categories CoinGecko tracks. | ||
| data.coins_tracked | integer | No | 17677 | Number of coins CoinGecko tracks. | ||
| data.ethereum_dominance_percent | number | No | 17.2 | Ethereum share of the total crypto market capitalisation, in percent. | ||
| data.exchanges_tracked | integer | No | 1233 | Number of exchanges CoinGecko tracks. | ||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.market_cap_change_1y_percent | number | No | 68.4 | Change in total market capitalisation over the last year, in percent. | ||
| data.market_cap_change_24h_percent | number | No | 1.2 | Change in total market capitalisation over the last 24 hours, in percent. | ||
| data.market_cap_usd | number | No | 2670000000000 | Total crypto market capitalisation, in US dollars. | ||
| data.source_url | string | No | https://www.coingecko.com/en/charts | URL the data was read from. | ||
| data.stablecoin_market_cap_usd | number | No | 161000000000 | Combined stablecoin market capitalisation, in US dollars. | ||
| data.stablecoin_share_percent | number | No | 6.03 | Stablecoin share of the total crypto market capitalisation, in percent. | ||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/global" \
-H "x-api-key: $CRAWLORA_API_KEY"