Skip to main content
GET
Coin Historical Chart Data by Token Address

Notes

  • Find a token’s contract address on its CoinGecko page or via Coins List with include_platform=true.
  • Auto-granularity when interval is not specified:
    • 1 day from current time = 5-minutely 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
The last completed UTC day (00:00) is available 35 minutes after midnight (00:35 UTC). Cache expires at 00:40 UTC.

SDK Examples

Authorizations

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.

days
string
default:1
required

Data up to number of days ago. You may use any integer or max for number of days.

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