Skip to main content
GET
/
coins
/
{id}
/
market_chart
Coin Historical Chart Data by ID
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/{id}/market_chart \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "prices": [
    [
      1711843200000,
      69702.3087473573
    ],
    [
      1711929600000,
      71246.9514406015
    ],
    [
      1711983682000,
      68887.7495158568
    ]
  ],
  "market_caps": [
    [
      1711843200000,
      1370247487960.09
    ],
    [
      1711929600000,
      1401370211582.37
    ],
    [
      1711983682000,
      1355701979725.16
    ]
  ],
  "total_volumes": [
    [
      1711843200000,
      16408802301.8374
    ],
    [
      1711929600000,
      19723005998.215
    ],
    [
      1711983682000,
      30137418199.6431
    ]
  ]
}

​
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.
  • You may use tools like epoch converter to convert human readable date to UNIX timestamp.

​
Note

  • You may leave the interval as empty for automatic granularity:
    • 1 day from current time = 5-minutely data
    • 2 - 90 days from current time = hourly data
    • above 90 days from current time = daily data (00:00 UTC)
  • Cache / Update Frequency:
    • Every 30 seconds for all the API plans (for last data point).
    • The last completed UTC day (00:00) data is now available 10 minutes after midnight on the next UTC day (00:10).
  • 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

​
vs_currency
string
default:usd
required
Example:
​
days
string
default:1
required
​
interval
enum<string>
Available options:
daily
​
precision
enum<string>
Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18

Response

200 - application/json
​
prices
number[][]
​
market_caps
number[][]
​
total_volumes
number[][]