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. - Values may be revised for up to 2 days after the date as later data settles.
The last completed UTC day (00:00) is available after 00:35 UTC the next day.
Historical data on the Basic plan is restricted to the past 2 years. Subscribe to Analyst plan & above for the full range.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
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
Path Parameters
Asset platform ID.
*refers to /asset_platforms.
Response
200 - application/json
Coin historical chart data by token address
Was this page helpful?

