Coin Historical Chart Data within Time Range by Token Address

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>'

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

GET

coins

{id}

contract

{contract_address}

market_chart

range

Coin Historical Chart Data within Time Range by Token Address

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>'

{
  "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:
Date range Granularity
1 day from current time 5-minutely
1 day from any other time hourly
2–90 days hourly
Above 90 days daily (00:00 UTC)
Enterprise plan subscribers can bypass auto-granularity:
interval Per request
hourly Any 100 days
5m Any 10 days
1m Any 1 day (Beta)
Data availability: 1m from 1 Jun 2026, 5m from 9 Feb 2018, hourly from 30 Jan 2018.

Date range	Granularity
1 day from current time	5-minutely
1 day from any other time	hourly
2–90 days	hourly
Above 90 days	daily (00:00 UTC)

`interval`	Per request
`hourly`	Any 100 days
`5m`	Any 10 days
`1m`	Any 1 day (Beta)

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.getRange('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', {
  id: 'ethereum',
  vs_currency: 'usd',
  from: '2025-12-22',
  to: '2025-12-31',
});

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

response = client.coins.contract.market_chart.get_range(
  "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  id="ethereum",
  vs_currency="usd",
  from_="2025-12-22",
  to="2025-12-31",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

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-12-22

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.

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:

1m,

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

CoinGecko API

Onchain API

Coin Historical Chart Data within Time Range by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples