GET
/
coins
/
{id}
/
history
Coin Historical Data by ID
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/history \
  --header 'x-cg-pro-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": 1270.646,
      "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": 24257046694416.7,
      "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": 731967149325.999,
      "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).

Authorizations

​
x-cg-pro-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:2024-01-01
required

date of data snapshot (YYYY-MM-DD or YYYY-MM-DDTHH:MM)

​
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