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
}
}Coins
Coin Historical Data by ID
To query the historical data (price, market cap, 24hrs volume, etc.) at a given date for a coin based on a particular coin ID
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
- Find a coin’s API ID on its CoinGecko page, via Coins List, or this Google Sheet.
- Data returned is a snapshot at
00:00:00 UTCfor the given date.
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
headerAuthqueryAuth
Path Parameters
Coin ID.
*refers to /coins/list.
Query Parameters
The date of data snapshot.
Format: dd-mm-yyyy
Include all the localized languages in response. Default: true
Response
200 - application/json
Coin historical data
Coin ID
Coin symbol
Coin name
Coin image URLs
Show child attributes
Show child attributes
Market data at the given date
Show child attributes
Show child attributes
Community engagement data
Show child attributes
Show child attributes
Developer activity data
Show child attributes
Show child attributes
Public interest statistics
Show child attributes
Show child attributes
Localized coin names keyed by locale code
Show child attributes
Show child attributes
Was this page helpful?
⌘I

