Home · APIs · Crypto · CoinGecko coin

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

FieldTypeValue in the sample
platformstringcoingecko
coin_idstringbitcoin
namestringBitcoin
symbolstringBTC
ranknumber1
price_usdnumber61665
price_change_24h_pctnumber-3.41934
price_change_7d_pctnumber-10.68323
price_change_30d_pctnumber-26.02183
market_cap_usdnumber1240242646061
fully_diluted_valuation_usdnumber1240242646061
volume_24h_usdnumber38886263862
circulating_supplynumber20114434
total_supplynumber20114434
max_supplynumber21000000
ath_usdnumber126080
ath_datestring2025-10-06T10:57:42.000Z
atl_usdnumber67.81
atl_datestring2013-07-05T16:00:00.000Z
sentiment_votes_up_pctnumber56.38
sentiment_votes_down_pctnumber43.62
watchlist_portfolio_usersnumber2486720
categorieslist["Smart Contract Platform","Layer 1 (L1)","FTX Holdings"]
homepagestringhttp://www.bitcoin.org
blockchain_siteslist["https://mempool.space/","https://platform.arkhamintelligence.com/explorer/token/bitcoin","https://blockch...
github_reposlist["https://github.com/bitcoin/bitcoin","https://github.com/bitcoin/bips"]
description_enstringBitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Naka...
genesis_datestring2009-01-03
last_updatedstring2026-11-20T10:20:57.000Z
coingecko_urlstringhttps://www.coingecko.com/en/coins/bitcoin
credits_usednumber2
latency_msnumber180

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"}'
import requests

r = requests.post(
    "https://api.foxapis.com/v1/crypto/coingecko/coin",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"coin_id":"bitcoin"},
)
print(r.json())
const r = await fetch("https://api.foxapis.com/v1/crypto/coingecko/coin", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"coin_id":"bitcoin"}),
});
console.log(await r.json());

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

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

Same category: Crypto · all APIs

How we calculate

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.