Skip to main content
GET
Coin Market Chart Range
Historical series for one coin between two explicit points in time. from and to are Unix timestamps in seconds, while the timestamps inside the response are in milliseconds — the two are not the same unit, which is the usual source of empty or misaligned results. Returns prices, market_caps and total_volumes as timestamp-and-value pairs; CoinGecko picks granularity from the window length. Use it to line a series up with a known event window. For a trailing window ending now, get_coingecko_coins_id_market_chart takes a days count instead.

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.

from
integer
required

Start UNIX timestamp (seconds).

to
integer
required

End UNIX timestamp (seconds).

precision
string

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

Response

Same shape as /coins/{id}/market_chart.

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