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

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
Example:

Query Parameters

date
string
default:30-12-2023
required
Example:
localization
boolean

Response

200 - application/json
id
string
symbol
string
name
string
localization
object
image
object
market_data
object
community_data
object
developer_data
object
public_interest_stats
object