Coin Historical Chart Data by Token Address
curl --request GET \
--url https://api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-demo-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://api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-demo-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) - 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 via the Demo API is restricted to the past 365 days. 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?

