Coin Historical Chart Data within Time Range by ID

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

{
  "prices": [
    [
      1779027899041,
      77953.82550382407
    ],
    [
      1779028199661,
      78052.87543398788
    ]
  ],
  "market_caps": [
    [
      1779027899041,
      1560631481361.8042
    ],
    [
      1779028199661,
      1562027330524.267
    ]
  ],
  "total_volumes": [
    [
      1779027899041,
      18688431751.857048
    ],
    [
      1779028199661,
      18974828816.446976
    ]
  ]
}

GET

coins

{id}

market_chart

range

Coin Historical Chart Data within Time Range by ID

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

{
  "prices": [
    [
      1779027899041,
      77953.82550382407
    ],
    [
      1779028199661,
      78052.87543398788
    ]
  ],
  "market_caps": [
    [
      1779027899041,
      1560631481361.8042
    ],
    [
      1779028199661,
      1562027330524.267
    ]
  ],
  "total_volumes": [
    [
      1779027899041,
      18688431751.857048
    ],
    [
      1779028199661,
      18974828816.446976
    ]
  ]
}

Notes

Find a coin’s API ID on its CoinGecko page, via Coins List, or this Google Sheet.
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)
Override with the interval parameter:
- daily: daily historical data
- hourly: hourly data, up to any 100 days per request
- 5m: 5-minutely data, up to any 10 days per request (Enterprise only)
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

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

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

response = client.coins.market_chart.get_range(
  "bitcoin",
  vs_currency="usd",
  from_="2025-01-01",
  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:bitcoin

required

Coin ID. *refers to /coins/list.

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.

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

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

Coin Historical Chart Data by ID Coin Historical Chart Data by Token Address

CoinGecko API

Onchain API

Coin Historical Chart Data within Time Range by ID

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples