CoinGecko API endpoint
Returns derived price-chart metrics from CoinGecko public chart JSON. This endpoint supports the documented `vs_currency` enum and is not investment advice or real-time trading data.
/coingecko/coin/{id}/analysisPath parameters:
id: CoinGecko coin slug/API id, for example bitcoin.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.range: Chart range. Allowed values: 24h, max. Defaults to 24h.include_annotations: Whether to request chart annotations. Defaults to false.Notable response behavior:
include_annotations=true, available chart annotation objects are returned with annotations_source_url.| Field | Filled in, of 120 checked | Values in the sample |
|---|---|---|
| timestamp | 120 | 2026-10-12 to 2026-10-13 |
| datetime | 120 | 2026-10-12 to 2026-10-13 |
| price | 120 | 81,333 to 83,964.94, median 83,224.89 |
| 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. | ||
| range | string | No | Chart range Allowed values: 24h, max. | ||
| include_annotations | boolean | No | Fetch optional CoinGecko chart annotations | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/coingecko/coin/bitcoin/analysis?vs_currency=btc&range=24h&include_annotations=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "ok",
"data": {
"id": "bitcoin",
"vs_currency": "usd",
"range": "24h",
"source_url": "https://www.coingecko.com/price_charts/bitcoin/usd/24_hours.json",
"fetched_at": "2026-05-24T00:00:00Z",
"first_price": 75386.89,
"last_price": 76535.94,
"min_price": 75344.2,
"max_price": 77216.4,
"absolute_change": 1149.05,
"percent_change": 1.52,
"high_low_range_percent": 2.48,
"points_count": 288,
"points": [
{
"timestamp": 1779556795943,
"datetime": "2026-05-24T00:00:00Z",
"price": 75386.89
}
]
}
}Request schema
No body schema
Response schema
#/definitions/coingecko.analysisResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | coingecko.AnalysisResponse | No | ||||
| data.absolute_change | number | No | 1149.04 | |||
| data.annotations | array | No | ||||
| data.annotations_point_count | integer | No | 3 | |||
| data.annotations_source_url | string | No | https://www.coingecko.com/price_charts/bitcoin/chart_insight/annotations?range=h24 | |||
| data.fetched_at | string | No | 2026-05-24T00:00:00Z | |||
| data.first_price | number | No | 75386.89 | |||
| data.high_low_range_percent | number | No | 2.48 | |||
| data.id | string | No | bitcoin | |||
| data.last_price | number | No | 76535.94 | |||
| data.max_price | number | No | 77216.4 | |||
| data.min_price | number | No | 75344.2 | |||
| data.percent_change | number | No | 1.52 | |||
| data.points | array | No | ||||
| data.points[].datetime | string | No | 2026-05-24T00:00:00Z | |||
| data.points[].price | number | No | 75386.89 | |||
| data.points[].timestamp | integer | No | 1779556795943 | |||
| data.points_count | integer | No | 288 | |||
| data.range | string | No | 24h | |||
| data.source_url | string | No | https://www.coingecko.com/price_charts/bitcoin/usd/24_hours.json | |||
| data.vs_currency | string | No | usd | |||
| 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/coin/bitcoin/analysis?vs_currency=btc&range=24h&include_annotations=true" \
-H "x-api-key: $CRAWLORA_API_KEY"