Skip to main content
GET
/
coins
/
{id}
/
history
Coin Historical Data by ID
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/{id}/history \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "localization": {
    "en": "Bitcoin",
    "zh": "比特币",
    "zh-tw": "比特幣",
    "de": "Bitcoin",
    "fr": "Bitcoin",
    "es": "Bitcoin",
    "ja": "ビットコイン",
    "id": "Bitcoin",
    "ru": "Биткоин",
    "ko": "비트코인",
    "ar": "بيتكوين",
    "th": "บิตคอยน์",
    "vi": "Bitcoin",
    "it": "Bitcoin",
    "pl": "Bitcoin",
    "tr": "Bitcoin",
    "hu": "Bitcoin",
    "nl": "Bitcoin",
    "ro": "Bitcoin",
    "sv": "Bitcoin",
    "cs": "Bitcoin",
    "da": "Bitcoin",
    "el": "Bitcoin",
    "hi": "Bitcoin",
    "no": "Bitcoin",
    "sk": "Bitcoin",
    "uk": "Bitcoin",
    "he": "Bitcoin",
    "fi": "Bitcoin",
    "bg": "Bitcoin",
    "hr": "Bitcoin",
    "lt": "Bitcoin",
    "sl": "Bitcoin",
    "pt": "Bitcoin"
  },
  "image": {
    "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
    "small": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
  },
  "market_data": {
    "current_price": {
      "aed": 155021.01870663263,
      "ars": 34223222.03038811,
      "aud": 61961.64079464181,
      "bch": 162.9444394169128,
      "bdt": 4640974.295329716,
      "bhd": 15935.706731619232,
      "bmd": 42208.202176186474,
      "bnb": 135.24654224991627,
      "brl": 204813.86598107114,
      "btc": 1,
      "cad": 55925.65684243621,
      "chf": 35496.88698916195,
      "clp": 37196103.56833302,
      "cny": 298785.10989287664,
      "czk": 944615.3438828368,
      "dkk": 285068.92147269147,
      "dot": 5160.299955562896,
      "eos": 50098.037591566885,
      "eth": 18.514283305187227,
      "eur": 38240.20908960317,
      "gbp": 33156.484386694596,
      "gel": 113329.02284306048,
      "hkd": 329606.38328597124,
      "huf": 14657368.01641012,
      "idr": 649885162.0865278,
      "ils": 152105.57155771676,
      "inr": 3513053.119048727,
      "jpy": 5952559.440604322,
      "krw": 54661344.54593342,
      "kwd": 12984.298194449415,
      "lkr": 13696906.151726862,
      "ltc": 579.0962960970021,
      "mmk": 88806742.41781776,
      "mxn": 716452.3647481233,
      "myr": 194052.20950501712,
      "ngn": 37886364.22413555,
      "nok": 429442.7101393702,
      "nzd": 66802.583918633,
      "php": 2338503.1911612307,
      "pkr": 11792242.372501094,
      "pln": 165880.09171330827,
      "rub": 3767047.138041446,
      "sar": 158357.45046405343,
      "sek": 425811.11642413173,
      "sgd": 55694.77797653248,
      "sol": 416.5289478886034,
      "thb": 1453127.860988517,
      "try": 1243001.417432343,
      "twd": 1295461.9075007213,
      "uah": 1607901.3285893872,
      "usd": 42208.202176186474,
      "vef": 4226.30728390156,
      "vnd": 1024346748.4635574,
      "xag": 1773.9385614394023,
      "xau": 20.435523165622502,
      "xdr": 31508.676173736272,
      "xlm": 327801.5907899002,
      "xrp": 68792.39040895543,
      "yfi": 5.23330767599715,
      "zar": 772207.5004537676,
      "bits": 999797.6500840397,
      "link": 2828.6459350540995,
      "sats": 99979765.00840396
    },
    "market_cap": {
      "aed": 3039570628249.035,
      "ars": 671030943774608.1,
      "aud": 1214911274669.9553,
      "bch": 3192400331.4673758,
      "bdt": 90997783863352.8,
      "bhd": 312458958958.8847,
      "bmd": 827596236151.1959,
      "bnb": 2647323702.8955383,
      "brl": 4015882597651.6562,
      "btc": 19586150,
      "cad": 1096560874919.1543,
      "chf": 696004296621.9747,
      "clp": 729321641896660.1,
      "cny": 5858421340316.535,
      "czk": 18521521005440.16,
      "dkk": 5589481529435.656,
      "dot": 101067225072.82333,
      "eos": 981764701266.0074,
      "eth": 362734483.2978319,
      "eur": 749793913990.623,
      "gbp": 650114912923.6271,
      "gel": 2222095894065.9663,
      "hkd": 6462748663878.865,
      "huf": 287393965552690.7,
      "idr": 12742606563251504,
      "ils": 2982406073429.352,
      "inr": 68882098474316.74,
      "jpy": 116714655790049.02,
      "krw": 1071770904156178.4,
      "kwd": 254589292146.01266,
      "lkr": 268561734299139.16,
      "ltc": 11369266145.87004,
      "mmk": 1741275912749029.8,
      "mxn": 14047821273508.254,
      "myr": 3804873695705.123,
      "ngn": 742855909912170.9,
      "nok": 8420286869134.373,
      "nzd": 1309829942186.6091,
      "php": 45852141040124.65,
      "pkr": 231216088345279.94,
      "pln": 3252489622308.595,
      "rub": 73862279654407,
      "sar": 3104989627928.0786,
      "sek": 8349080488975.917,
      "sgd": 1092033923507.4076,
      "sol": 8167080608.685882,
      "thb": 28493545024184.4,
      "try": 24372118250940.145,
      "twd": 25400735957660.043,
      "uah": 31526883852775.1,
      "usd": 827596236151.1959,
      "vef": 82867211125.81927,
      "vnd": 20084852465487144,
      "xag": 34782454615.8709,
      "xau": 400688993.6949639,
      "xdr": 617805555864.2843,
      "xlm": 6420377180809.443,
      "xrp": 1347730925908.2449,
      "yfi": 102656498.40039586,
      "zar": 15141038659633.365,
      "bits": 19587615789973.43,
      "link": 55342736984.57576,
      "sats": 1958761578997342.8
    },
    "total_volume": {
      "aed": 52093574029.40443,
      "ars": 11500440167656.37,
      "aud": 20821714040.129295,
      "bch": 54756176.21574547,
      "bdt": 1559562309933.2505,
      "bhd": 5355066850.034618,
      "bmd": 14183728910.169804,
      "bnb": 45448519.30208316,
      "brl": 68826062289.8161,
      "btc": 335974.0074837291,
      "cad": 18793369887.330444,
      "chf": 11928445094.808254,
      "clp": 12499453241945.738,
      "cny": 100404347558.46667,
      "czk": 317430434636.70953,
      "dkk": 95795132093.1731,
      "dot": 1734077546.3343449,
      "eos": 16835045026.655567,
      "eth": 6221576.893294353,
      "eur": 12850316555.324738,
      "gbp": 11141971510.468252,
      "gel": 38083312123.805855,
      "hkd": 110761590083.25078,
      "huf": 4925491344396.748,
      "idr": 218388713248196.1,
      "ils": 51113861322.39222,
      "inr": 1180533415747.48,
      "jpy": 2000310012607.8845,
      "krw": 18368507847565.402,
      "kwd": 4363269605.991003,
      "lkr": 4602735813129.19,
      "ltc": 194600680.75008962,
      "mmk": 29842795828917.508,
      "mxn": 240758089534.80554,
      "myr": 65209693664.5056,
      "ngn": 12731409817077.545,
      "nok": 144310789586.34262,
      "nzd": 22448474276.294495,
      "php": 785835302355.318,
      "pkr": 3962688776849.6025,
      "pln": 55742678701.03927,
      "rub": 1265886075288.8472,
      "sar": 53214755248.56654,
      "sek": 143090421550.91183,
      "sgd": 18715784890.19182,
      "sol": 139971223.0203305,
      "thb": 488312000734.88245,
      "try": 417700689222.06055,
      "twd": 435329617517.0529,
      "uah": 540322387194.22906,
      "usd": 14183728910.169804,
      "vef": 1420216775.7753053,
      "vnd": 344223535737756.94,
      "xag": 596117871.9180025,
      "xau": 6867194.189147832,
      "xdr": 10588238733.815224,
      "xlm": 110155103993.25989,
      "xrp": 23117132839.969418,
      "yfi": 1758611.2071300931,
      "zar": 259494157157.33887,
      "bits": 335974007483.7291,
      "link": 950543853.0214615,
      "sats": 33597400748372.91
    }
  },
  "community_data": {
    "facebook_likes": null,
    "reddit_average_posts_48h": 0,
    "reddit_average_comments_48h": 0,
    "reddit_subscribers": null,
    "reddit_accounts_active_48h": 0
  },
  "developer_data": {
    "forks": null,
    "stars": null,
    "subscribers": null,
    "total_issues": null,
    "closed_issues": null,
    "pull_requests_merged": null,
    "pull_request_contributors": null,
    "code_additions_deletions_4_weeks": {
      "additions": null,
      "deletions": null
    },
    "commit_count_4_weeks": null
  },
  "public_interest_stats": {
    "alexa_rank": null,
    "bing_matches": null
  }
}

Notes

The last completed UTC day (00:00) becomes available 35 minutes after midnight (00:35 UTC).
Historical data via the Demo API is restricted to the past 365 days. Subscribe to a paid plan for the full range.

SDK Examples

const response = await client.coins.history.get('bitcoin', {
  date: '2025-12-30',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

x-cg-demo-api-key
string
header
required

Path Parameters

id
string
default:bitcoin
required

Coin ID. *refers to /coins/list.

Query Parameters

date
string
default:30-12-2025
required

The date of data snapshot. Format: dd-mm-yyyy

localization
boolean

Include all the localized languages in response. Default: true

Response

200 - application/json

Coin historical data

id
string
required

Coin ID

symbol
string
required

Coin symbol

name
string
required

Coin name

image
object
required

Coin image URLs

market_data
object
required

Market data at the given date

community_data
object
required

Community engagement data

developer_data
object
required

Developer activity data

public_interest_stats
object
required

Public interest statistics

localization
object

Localized coin names keyed by locale code