Coin Historical Chart Data within Time Range by Token Address

To get the historical chart data within certain time range in UNIX along with price, market cap and 24hrs volume based on asset platform and particular token contract address

GET /coins/{id}/contract/{contract_address}/market_chart/range

Coin Historical Chart Data within Time Range by Token Address

cURL

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart/range \
  --header 'x-cg-pro-api-key: <api-key>'

200

{
  "prices": [
    [
      1735689600000,
      1.000540738607754
    ],
    [
      1735776000000,
      0.9995995563541714
    ]
  ],
  "market_caps": [
    [
      1735689600000,
      43945617394.42927
    ],
    [
      1735776000000,
      43740787028.36501
    ]
  ],
  "total_volumes": [
    [
      1735689600000,
      6544488766.849924
    ],
    [
      1735776000000,
      5447401746.320422
    ]
  ]
}

Notes

• Find a token’s contract address on its CoinGecko page or via Coins List with include_platform=true.
• Accepts ISO date strings (YYYY-MM-DD or YYYY-MM-DDTHH:MM, recommended) or UNIX timestamps for from and to.
• Auto-granularity when interval is not specified:
  • 1 day from current time = 5-minutely data
  • 1 day from any other time = hourly data
  • 2–90 days = hourly data
  • Above 90 days = daily data (00:00 UTC)
• Enterprise plan subscribers can bypass auto-granularity:
  • interval=5m: 5-minutely data, up to the past 10 days
  • interval=hourly: hourly data, up to the past 100 days
• Data availability: 5m from 9 Feb 2018, hourly from 30 Jan 2018.

Cache / Update Frequency:

Date Range	Cache
1 day	30 seconds
2–90 days	30 minutes
Above 90 days	12 hours

The last completed UTC day (00:00) is available 35 minutes after midnight (00:35 UTC). Cache expires at 00:40 UTC.

SDK Examples

TypeScript

const response = await client.coins.contract.marketChart.getRange('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', {
  id: 'ethereum',
  vs_currency: 'usd',
  from: '2025-01-01',
  to: '2025-12-31',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

headerAuthqueryAuth

x-cg-pro-api-key · string · header · required

Learn how to set up your API key

Path Parameters

id · string · default: ethereum · required

Asset platform ID. *refers to /asset_platforms.

contract_address · string · default: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 · required

The contract address of token.

Query Parameters

vs_currency · string · default: usd · required

Target currency of market data. *refers to /simple/supported_vs_currencies.

from · string · default: 2025-01-01 · required

Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

to · string · default: 2025-12-31 · required

Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

interval · enum<string>

Data interval, leave empty for auto granularity.

Available options: 5m, hourly, daily

precision · enum<string>

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 within time range by token address

prices · number[][] · required

Price data points as [timestamp, price] pairs

market_caps · number[][] · required

Market cap data points as [timestamp, market_cap] pairs

total_volumes · number[][] · required

Total volume data points as [timestamp, volume] pairs