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",
    "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
  }
}

​
Notice

  • Please note that the twitter_followers data field will no longer be supported by our API starting on May 15, 2025. Please refer to changelog for more details.

​
Tips

  • You may obtain the coin ID (API ID) via several ways:
    • refers to respective coin page and find ‘API ID’.
    • refers to /coins/list endpoint.
    • refers to Google Sheets here.

​
Note

  • The data returned is at 00:00:00 UTC.
  • The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).
  • Access to historical data via the Public API (Demo plan) is restricted to the past 365 days only. To access the complete range of historical data, please subscribe to one of our paid plans to obtain a Pro-API key.

Authorizations

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

Path Parameters

​
id
string
default:bitcoin
required

coin ID *refers to /coins/list.

Example:

"bitcoin"

Query Parameters

​
date
string
default:30-12-2023
required

the date of data snapshot Format: dd-mm-yyyy

Example:

"30-12-2023"

​
localization
boolean

include all the localized languages in response, default: true

Response

200 - application/json

Get historical data (name, price, market, stats) at a given date for a coin

​
id
string

coin ID

​
symbol
string

coin symbol

​
name
string

coin name

​
localization
object

coin localization

​
image
object

coin image url

​
market_data
object

coin market data

​
community_data
object

coin community data

​
developer_data
object

coin developer data

​
public_interest_stats
object

coin public interest stats