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",
"de": "Bitcoin",
"es": "Bitcoin",
"fr": "Bitcoin",
"it": "Bitcoin",
"pl": "Bitcoin",
"ro": "Bitcoin",
"hu": "Bitcoin",
"nl": "Bitcoin",
"pt": "Bitcoin",
"sv": "Bitcoin",
"vi": "Bitcoin",
"tr": "Bitcoin",
"ru": "Биткоин",
"ja": "ビットコイン",
"zh": "比特币",
"zh-tw": "比特幣",
"ko": "비트코인",
"ar": "بيتكوين",
"th": "บิตคอยน์",
"id": "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"
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
},
"market_data": {
"current_price": {
"aed": 154530.091081427,
"ars": 33947900.261883,
"aud": 61738.4056950475,
"bch": 165.381674946306,
"bdt": 4617857.43751472,
"bhd": 15859.4297419179,
"bmd": 42074.7071561885,
"bnb": 134.15687497174,
"brl": 204167.474400698,
"btc": 1,
"cad": 55797.3728951794,
"chf": 35380.4108741032,
"clp": 37070945.9743491,
"cny": 297872.096782952,
"czk": 941726.6142466,
"dkk": 284202.024427907,
"dot": 5078.18455042231,
"eos": 49611.9119761598,
"eth": 18.2965432154039,
"eur": 38057.7086398657,
"gbp": 33025.6578133999,
"gel": 113180.962250147,
"hkd": 328622.396508053,
"huf": 14607917.5775571,
"idr": 647533950.604456,
"ils": 151504.709263362,
"inr": 3501412.9510955,
"jpy": 5933586.69083973,
"krw": 54466970.6549007,
"kwd": 12928.7160149536,
"lkr": 13628686.3687709,
"ltc": 573.662179787236,
"mmk": 88364275.7448308,
"mxn": 714058.270089106,
"myr": 193333.279382686,
"ngn": 37725865.4245248,
"nok": 429848.167317426,
"nzd": 66531.8087825235,
"php": 2330938.69230343,
"pkr": 11705926.3598065,
"pln": 165640.548626626,
"rub": 3755167.36124159,
"sar": 157780.151835706,
"sek": 423808.006507498,
"sgd": 55568.0657411781,
"sol": 1240206.60639855,
"thb": 1438863.97715007,
"try": 1240206.60639855,
"twd": 1291001.38076227,
"uah": 1599892.6750506,
"usd": 42074.7071561885,
"vef": 4212.94042754915,
"vnd": 1021106970.8227,
"xag": 1768.32799402537,
"xau": 20.3961350410339,
"xdr": 31351.757663898,
"xlm": 324963.641046826,
"xrp": 67529.863610982,
"yfi": 5.11694276059855,
"zar": 769994.699891437,
"bits": 1000195.71393105,
"link": 2709.66083650503,
"sats": 100019571.393105
},
"market_cap": {
"aed": 3022434823129.84,
"ars": 663982757051427,
"aud": 1207533794818.66,
"bch": 3239927812.61396,
"bdt": 90320099015790.6,
"bhd": 310192612917.673,
"bmd": 822933961870.542,
"bnb": 2629923038.04924,
"brl": 3993286227042.84,
"btc": 19584275,
"cad": 1091498460326.99,
"chf": 692169755329.313,
"clp": 725066019537891,
"cny": 5826043276458.69,
"czk": 18419113668077,
"dkk": 5558672032246.96,
"dot": 99489102293.3619,
"eos": 971966018054.879,
"eth": 358260658.630535,
"eur": 744365987728.877,
"gbp": 645995753662.719,
"gel": 2213692357431.75,
"hkd": 6427484562491.77,
"huf": 285714442221834,
"idr": 12665035966583838,
"ils": 2963261756601.54,
"inr": 68483700226206.6,
"jpy": 116054283764085,
"krw": 1065312701660270,
"kwd": 252871147803.58,
"lkr": 266561780855891,
"ltc": 11241964101.6977,
"mmk": 1728305874039080,
"mxn": 13966176853697.3,
"myr": 3781381554795.15,
"ngn": 737875507571602,
"nok": 8407346818129.71,
"nzd": 1301287369358.73,
"php": 45590539841760.1,
"pkr": 228954757091481,
"pln": 3239742879771.2,
"rub": 73446851159342,
"sar": 3086002357014.53,
"sek": 8289208064431.51,
"sgd": 1086848883442.42,
"sol": 822933961870.542,
"thb": 28142561489813.1,
"try": 24257046694416.7,
"twd": 25250535365752.9,
"uah": 31292101755089.6,
"usd": 822933961870.542,
"vef": 82400377602.0975,
"vnd": 19971704184972804,
"xag": 34586507200.3442,
"xau": 398925467.356364,
"xdr": 613205127018.025,
"xlm": 6366989968394.3,
"xrp": 1322171541704.13,
"yfi": 100197984.577011,
"zar": 15060230523976,
"bits": 19587833186725.1,
"link": 53027090934.8881,
"sats": 1958783318672510
},
"total_volume": {
"aed": 91203312150.0806,
"ars": 20035974370796.5,
"aud": 36437868164.374,
"bch": 97607892.5371449,
"bdt": 2725449072027.67,
"bhd": 9360199758.84335,
"bmd": 24832397519.0506,
"bnb": 79179085.8304717,
"brl": 120499184128.796,
"btc": 590313.260481799,
"cad": 32931483969.889,
"chf": 20881438911.7821,
"clp": 21879188925189.9,
"cny": 175803441475.871,
"czk": 555804929370.771,
"dkk": 167735395521.931,
"dot": 2997133098.58748,
"eos": 29280838849.3072,
"eth": 10798578.6487541,
"eur": 22461574030.7143,
"gbp": 19491668952.2309,
"gel": 66799149326.2464,
"hkd": 193952199202.669,
"huf": 8621560094639.22,
"idr": 382173081057941,
"ils": 89417738606.4736,
"inr": 2066526047518,
"jpy": 3501989517686,
"krw": 32146283560336.6,
"kwd": 7630499109.6539,
"lkr": 8043620037935.51,
"ltc": 338574128.091738,
"mmk": 52152396774457.3,
"mxn": 421435584775.312,
"myr": 114104866600.038,
"ngn": 22265720911481.5,
"nok": 253695421433.057,
"nzd": 39266923884.1294,
"php": 1375714772890.61,
"pkr": 6908811405778.09,
"pln": 97760679200.9487,
"rub": 2216291329580.89,
"sar": 93121490696.4396,
"sek": 250130532110.017,
"sgd": 32796147403.4102,
"sol": 24832397519.0506,
"thb": 849214282675.698,
"try": 731967149325.999,
"twd": 761946110895.665,
"uah": 944253057952.188,
"usd": 24832397519.0506,
"vef": 2486467963.58254,
"vnd": 602655037260634,
"xag": 1043663204.32594,
"xau": 12037753.021335,
"xdr": 18503736849.333,
"xlm": 191792809959.604,
"xrp": 39855973598.8211,
"yfi": 3020008.10704923,
"zar": 454449139819.002,
"bits": 590313260481.799,
"link": 1599235730.48563,
"sats": 59031326048179.9
}
},
"community_data": {
"facebook_likes": null,
"reddit_average_posts_48h": 0,
"reddit_average_comments_48h": 0,
"reddit_subscribers": null,
"reddit_accounts_active_48h": null
},
"developer_data": {
"forks": 36262,
"stars": 72871,
"subscribers": 3961,
"total_issues": 7736,
"closed_issues": 7377,
"pull_requests_merged": 11204,
"pull_request_contributors": 846,
"code_additions_deletions_4_weeks": {
"additions": 973,
"deletions": -290
},
"commit_count_4_weeks": 163
},
"public_interest_stats": {
"alexa_rank": null,
"bing_matches": null
}
}This endpoint allows you to query the historical data (price, market cap, 24hrs volume, …) at a given date for a coin based on a particular coin 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",
"de": "Bitcoin",
"es": "Bitcoin",
"fr": "Bitcoin",
"it": "Bitcoin",
"pl": "Bitcoin",
"ro": "Bitcoin",
"hu": "Bitcoin",
"nl": "Bitcoin",
"pt": "Bitcoin",
"sv": "Bitcoin",
"vi": "Bitcoin",
"tr": "Bitcoin",
"ru": "Биткоин",
"ja": "ビットコイン",
"zh": "比特币",
"zh-tw": "比特幣",
"ko": "비트코인",
"ar": "بيتكوين",
"th": "บิตคอยน์",
"id": "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"
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
},
"market_data": {
"current_price": {
"aed": 154530.091081427,
"ars": 33947900.261883,
"aud": 61738.4056950475,
"bch": 165.381674946306,
"bdt": 4617857.43751472,
"bhd": 15859.4297419179,
"bmd": 42074.7071561885,
"bnb": 134.15687497174,
"brl": 204167.474400698,
"btc": 1,
"cad": 55797.3728951794,
"chf": 35380.4108741032,
"clp": 37070945.9743491,
"cny": 297872.096782952,
"czk": 941726.6142466,
"dkk": 284202.024427907,
"dot": 5078.18455042231,
"eos": 49611.9119761598,
"eth": 18.2965432154039,
"eur": 38057.7086398657,
"gbp": 33025.6578133999,
"gel": 113180.962250147,
"hkd": 328622.396508053,
"huf": 14607917.5775571,
"idr": 647533950.604456,
"ils": 151504.709263362,
"inr": 3501412.9510955,
"jpy": 5933586.69083973,
"krw": 54466970.6549007,
"kwd": 12928.7160149536,
"lkr": 13628686.3687709,
"ltc": 573.662179787236,
"mmk": 88364275.7448308,
"mxn": 714058.270089106,
"myr": 193333.279382686,
"ngn": 37725865.4245248,
"nok": 429848.167317426,
"nzd": 66531.8087825235,
"php": 2330938.69230343,
"pkr": 11705926.3598065,
"pln": 165640.548626626,
"rub": 3755167.36124159,
"sar": 157780.151835706,
"sek": 423808.006507498,
"sgd": 55568.0657411781,
"sol": 1240206.60639855,
"thb": 1438863.97715007,
"try": 1240206.60639855,
"twd": 1291001.38076227,
"uah": 1599892.6750506,
"usd": 42074.7071561885,
"vef": 4212.94042754915,
"vnd": 1021106970.8227,
"xag": 1768.32799402537,
"xau": 20.3961350410339,
"xdr": 31351.757663898,
"xlm": 324963.641046826,
"xrp": 67529.863610982,
"yfi": 5.11694276059855,
"zar": 769994.699891437,
"bits": 1000195.71393105,
"link": 2709.66083650503,
"sats": 100019571.393105
},
"market_cap": {
"aed": 3022434823129.84,
"ars": 663982757051427,
"aud": 1207533794818.66,
"bch": 3239927812.61396,
"bdt": 90320099015790.6,
"bhd": 310192612917.673,
"bmd": 822933961870.542,
"bnb": 2629923038.04924,
"brl": 3993286227042.84,
"btc": 19584275,
"cad": 1091498460326.99,
"chf": 692169755329.313,
"clp": 725066019537891,
"cny": 5826043276458.69,
"czk": 18419113668077,
"dkk": 5558672032246.96,
"dot": 99489102293.3619,
"eos": 971966018054.879,
"eth": 358260658.630535,
"eur": 744365987728.877,
"gbp": 645995753662.719,
"gel": 2213692357431.75,
"hkd": 6427484562491.77,
"huf": 285714442221834,
"idr": 12665035966583838,
"ils": 2963261756601.54,
"inr": 68483700226206.6,
"jpy": 116054283764085,
"krw": 1065312701660270,
"kwd": 252871147803.58,
"lkr": 266561780855891,
"ltc": 11241964101.6977,
"mmk": 1728305874039080,
"mxn": 13966176853697.3,
"myr": 3781381554795.15,
"ngn": 737875507571602,
"nok": 8407346818129.71,
"nzd": 1301287369358.73,
"php": 45590539841760.1,
"pkr": 228954757091481,
"pln": 3239742879771.2,
"rub": 73446851159342,
"sar": 3086002357014.53,
"sek": 8289208064431.51,
"sgd": 1086848883442.42,
"sol": 822933961870.542,
"thb": 28142561489813.1,
"try": 24257046694416.7,
"twd": 25250535365752.9,
"uah": 31292101755089.6,
"usd": 822933961870.542,
"vef": 82400377602.0975,
"vnd": 19971704184972804,
"xag": 34586507200.3442,
"xau": 398925467.356364,
"xdr": 613205127018.025,
"xlm": 6366989968394.3,
"xrp": 1322171541704.13,
"yfi": 100197984.577011,
"zar": 15060230523976,
"bits": 19587833186725.1,
"link": 53027090934.8881,
"sats": 1958783318672510
},
"total_volume": {
"aed": 91203312150.0806,
"ars": 20035974370796.5,
"aud": 36437868164.374,
"bch": 97607892.5371449,
"bdt": 2725449072027.67,
"bhd": 9360199758.84335,
"bmd": 24832397519.0506,
"bnb": 79179085.8304717,
"brl": 120499184128.796,
"btc": 590313.260481799,
"cad": 32931483969.889,
"chf": 20881438911.7821,
"clp": 21879188925189.9,
"cny": 175803441475.871,
"czk": 555804929370.771,
"dkk": 167735395521.931,
"dot": 2997133098.58748,
"eos": 29280838849.3072,
"eth": 10798578.6487541,
"eur": 22461574030.7143,
"gbp": 19491668952.2309,
"gel": 66799149326.2464,
"hkd": 193952199202.669,
"huf": 8621560094639.22,
"idr": 382173081057941,
"ils": 89417738606.4736,
"inr": 2066526047518,
"jpy": 3501989517686,
"krw": 32146283560336.6,
"kwd": 7630499109.6539,
"lkr": 8043620037935.51,
"ltc": 338574128.091738,
"mmk": 52152396774457.3,
"mxn": 421435584775.312,
"myr": 114104866600.038,
"ngn": 22265720911481.5,
"nok": 253695421433.057,
"nzd": 39266923884.1294,
"php": 1375714772890.61,
"pkr": 6908811405778.09,
"pln": 97760679200.9487,
"rub": 2216291329580.89,
"sar": 93121490696.4396,
"sek": 250130532110.017,
"sgd": 32796147403.4102,
"sol": 24832397519.0506,
"thb": 849214282675.698,
"try": 731967149325.999,
"twd": 761946110895.665,
"uah": 944253057952.188,
"usd": 24832397519.0506,
"vef": 2486467963.58254,
"vnd": 602655037260634,
"xag": 1043663204.32594,
"xau": 12037753.021335,
"xdr": 18503736849.333,
"xlm": 191792809959.604,
"xrp": 39855973598.8211,
"yfi": 3020008.10704923,
"zar": 454449139819.002,
"bits": 590313260481.799,
"link": 1599235730.48563,
"sats": 59031326048179.9
}
},
"community_data": {
"facebook_likes": null,
"reddit_average_posts_48h": 0,
"reddit_average_comments_48h": 0,
"reddit_subscribers": null,
"reddit_accounts_active_48h": null
},
"developer_data": {
"forks": 36262,
"stars": 72871,
"subscribers": 3961,
"total_issues": 7736,
"closed_issues": 7377,
"pull_requests_merged": 11204,
"pull_request_contributors": 846,
"code_additions_deletions_4_weeks": {
"additions": 973,
"deletions": -290
},
"commit_count_4_weeks": 163
},
"public_interest_stats": {
"alexa_rank": null,
"bing_matches": null
}
}/coins/list endpoint.00:00:00 UTC.coin ID
*refers to /coins/list.
"bitcoin"
the date of data snapshot
Format: dd-mm-yyyy
"30-12-2023"
include all the localized languages in response, default: true
Get historical data (name, price, market, stats) at a given date for a coin
coin ID
coin symbol
coin name
coin market data
Show child attributes
coin community data
Show child attributes
coin facebook likes
coin reddit average posts 48h
coin reddit average comments 48h
coin reddit subscribers
coin reddit accounts active 48h
coin developer data
Show child attributes
coin repository forks
coin repository stars
coin repository subscribers
coin repository total issues
coin repository closed issues
coin repository pull requests merged
coin repository pull request contributors
coin commit count 4 weeks
Was this page helpful?