Coin Historical Chart Data by Token Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"prices": [
[
1779619498604,
0.9997624087636037
],
[
1779619877081,
0.9997817655336941
]
],
"market_caps": [
[
1779619498604,
76419636272.78033
],
[
1779619877081,
76424065983.84229
]
],
"total_volumes": [
[
1779619498604,
9374311493.936354
],
[
1779619877081,
9390008044.485624
]
]
}Coin Historical Chart Data by Token Address
To get the historical chart data including time in UNIX, price, market cap and 24hrs volume based on asset platform and particular token contract address
GET
/
coins
/
{id}
/
contract
/
{contract_address}
/
market_chart
Coin Historical Chart Data by Token Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"prices": [
[
1779619498604,
0.9997624087636037
],
[
1779619877081,
0.9997817655336941
]
],
"market_caps": [
[
1779619498604,
76419636272.78033
],
[
1779619877081,
76424065983.84229
]
],
"total_volumes": [
[
1779619498604,
9374311493.936354
],
[
1779619877081,
9390008044.485624
]
]
}Notes
-
Find a token’s contract address on its CoinGecko page or via Coins List with
include_platform=true. -
Auto-granularity when
intervalis not specified:Date range Granularity 1 day from current time 5-minutely 2–90 days hourly Above 90 days daily (00:00 UTC) -
Enterprise plan subscribers can bypass auto-granularity:
intervalLookback hourlyPast 100 days 5mPast 10 days 1mPast 1 day (Beta) -
Data availability:
1mfrom 1 Jun 2026,5mfrom 9 Feb 2018,hourlyfrom 30 Jan 2018.
The last completed UTC day (00:00) is available 35 minutes after midnight (00:35 UTC). Cache expires at 00:40 UTC.
Historical data on the Basic plan is restricted to the past 2 years. Subscribe to Analyst plan & above for the full range.
SDK Examples
const response = await client.coins.contract.marketChart.get('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', {
id: 'ethereum',
vs_currency: 'usd',
days: '1',
});
console.log(JSON.stringify(response, null, 2));
response = client.coins.contract.market_chart.get(
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
id="ethereum",
vs_currency="usd",
days="1",
)
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
Target currency of market data.
*refers to /simple/supported_vs_currencies.
Data up to number of days ago.
You may use any integer or max for number of days.
Data interval, leave empty for auto granularity.
Available options:
1m, 5m, hourly, daily Decimal place for currency price value.
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
Coin historical chart data by token address
Was this page helpful?