Skip to main content
GET
Coin Historical Chart
Historical series for one coin over a trailing window set by days, returned as three parallel arrays: prices, market_caps and total_volumes. Each entry is a two-element pair of timestamp and value, and the timestamp is in milliseconds. Granularity follows days automatically, or force it with interval (daily or hourly). Use it to chart a trend ending now. For an explicit start and end use get_coingecko_coins_id_market_chart_range; for candlesticks use get_coingecko_coins_id_ohlc; for one specific past day use get_coingecko_coins_id_history.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

CoinGecko coin ID (e.g., bitcoin, ethereum). Get the list via /coins/list.

Query Parameters

vs_currency
string
default:usd
required

Target currency for price (e.g., usd, eur, btc). See /simple/supported_vs_currencies.

days
string
required

Data up to N days ago. Accepts 1, 7, 14, 30, 90, 180, 365, or max.

interval
enum<string>

Data interval. CoinGecko supports daily; hourly is also available for supported ranges.

Available options:
daily,
hourly
precision
string

full or a value from 0 to 18 to specify decimal places for currency price values.

Response

200 - application/json

Three time-series arrays.

prices
number[][]
market_caps
number[][]
total_volumes
number[][]