CoinGecko coin API
One request, one key: POST /v1/crypto/coingecko/coin. The sample below is a real response captured 20 November 2026, shortened for display (long text cut, lists cut to three items); it is not invented.
Price
2 credits a call. One call is about $0.0196 and 1,000 calls are about $19.60 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.
Try it free
Runs one real call with the sample input below. No key and no sign-up; a few runs a day per visitor.
{
"coin_id": "bitcoin"
}
What it returns
| Field | Type | Value in the sample |
|---|---|---|
platform | string | coingecko |
coin_id | string | bitcoin |
name | string | Bitcoin |
symbol | string | BTC |
rank | number | 1 |
price_usd | number | 61665 |
price_change_24h_pct | number | -3.41934 |
price_change_7d_pct | number | -10.68323 |
price_change_30d_pct | number | -26.02183 |
market_cap_usd | number | 1240242646061 |
fully_diluted_valuation_usd | number | 1240242646061 |
volume_24h_usd | number | 38886263862 |
circulating_supply | number | 20114434 |
total_supply | number | 20114434 |
max_supply | number | 21000000 |
ath_usd | number | 126080 |
ath_date | string | 2025-10-06T10:57:42.000Z |
atl_usd | number | 67.81 |
atl_date | string | 2013-07-05T16:00:00.000Z |
sentiment_votes_up_pct | number | 56.38 |
sentiment_votes_down_pct | number | 43.62 |
watchlist_portfolio_users | number | 2486720 |
categories | list | ["Smart Contract Platform","Layer 1 (L1)","FTX Holdings"] |
homepage | string | http://www.bitcoin.org |
blockchain_sites | list | ["https://mempool.space/","https://platform.arkhamintelligence.com/explorer/token/bitcoin","https://blockch... |
github_repos | list | ["https://github.com/bitcoin/bitcoin","https://github.com/bitcoin/bips"] |
description_en | string | Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Naka... |
genesis_date | string | 2009-01-03 |
last_updated | string | 2026-11-20T10:20:57.000Z |
coingecko_url | string | https://www.coingecko.com/en/coins/bitcoin |
credits_used | number | 2 |
latency_ms | number | 180 |
Sample response (20 November 2026)
{
"platform": "coingecko",
"coin_id": "bitcoin",
"name": "Bitcoin",
"symbol": "BTC",
"rank": 1,
"price_usd": 61665,
"price_change_24h_pct": -3.41934,
"price_change_7d_pct": -10.68323,
"price_change_30d_pct": -26.02183,
"market_cap_usd": 1240242646061,
"fully_diluted_valuation_usd": 1240242646061,
"volume_24h_usd": 38886263862,
"circulating_supply": 20114434,
"total_supply": 20114434,
"max_supply": 21000000,
"ath_usd": 126080,
"ath_date": "2025-10-06T10:57:42.000Z",
"atl_usd": 67.81,
"atl_date": "2013-07-05T16:00:00.000Z",
"sentiment_votes_up_pct": 56.38,
"sentiment_votes_down_pct": 43.62,
"watchlist_portfolio_users": 2486720,
"developer_forks": null,
"developer_stars": null,
"developer_subscribers": null,
"developer_total_issues": null,
"developer_closed_issues": null,
"developer_commits_4w": null,
"categories": [
"Smart Contract Platform",
"Layer 1 (L1)",
"FTX Holdings"
],
"homepage": "http://www.bitcoin.org",
"blockchain_sites": [
"https://mempool.space/",
"https://platform.arkhamintelligence.com/explorer/token/bitcoin",
"https://blockchair.com/bitcoin/"
],
"github_repos": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
],
"description_en": "Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto. It enables peer-to-peer electronic cash transactions without intermediaries like banks or governments, operating on a blockchain secured by Proof of Work mining and the SHA-256 cryptograp...",
"genesis_date": "2009-01-03",
"last_updated": "2026-11-20T10:20:57.000Z",
"coingecko_url": "https://www.coingecko.com/en/coins/bitcoin",
"errors": [],
"credits_used": 2,
"latency_ms": 180
}
Measured on that call: 698 ms.
Code
curl -X POST https://api.foxapis.com/v1/crypto/coingecko/coin \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"coin_id":"bitcoin"}'n8n (HTTP Request node: paste it into a workflow)
{
"nodes": [
{
"name": "CoinGecko coin",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.foxapis.com/v1/crypto/coingecko/coin",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_KEY"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"coin_id\":\"bitcoin\"}"
}
}
],
"connections": {}
}Assistants (Claude, ChatGPT, Cursor)
Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.
claude mcp add --transport http foxapis https://foxapis.com/mcp \ --header "Authorization: Bearer YOUR_KEY"
Errors and limits
- 401: the key is missing or wrong.
- 402: out of credits; top up on the pricing page.
- 422: the input does not match; the answer names the field.
- 429: too many calls too fast; wait a moment and try again.
- 503: the source did not answer; nothing is charged. Live state: status.
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keySame category: Crypto · all APIs
How we calculate
- Price of one call and of 1,000 calls: The credits per call times the smallest paid plan's price per credit (its monthly price divided by its monthly credits), times 1,000 for the larger figure.
Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.