Skip to main content
GET
/
coins
/
{id}
/
contract
/
{contract_address}
/
market_chart
/
range
Coin Historical Chart Data within Time Range by Token Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart/range \
  --header 'x-cg-demo-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:
    • 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)
Cache / Update Frequency:
Date RangeCache
1 day30 seconds
2–90 days30 minutes
Above 90 days12 hours
The last completed UTC day (00:00) is available 35 minutes after midnight (00:35 UTC). Cache expires at 00:40 UTC.
Historical data via the Demo API is restricted to the past 365 days. Subscribe to a paid plan for the full range.

​
SDK Examples

const response = await client.coins.contract.marketChart.getRange('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', {
  id: 'ethereum',
  vs_currency: 'usd',
  from: '1767024000',
  to: '1777564800',
});

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

Authorizations

​
x-cg-demo-api-key
string
header
required

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
integer
default:1767024000
required

Starting date in UNIX timestamp.

​
to
integer
default:1777564800
required

Ending date in UNIX timestamp.

​
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