Skip to main content
GET
Coin Market Chart Range by Contract
Historical series between two explicit points in time for a token identified by contract address. id is the asset platform and contract_address the token; from and to are Unix timestamps in seconds while response timestamps are in milliseconds. Returns prices, market_caps and total_volumes as timestamp-and-value pairs. Use it when you have an address and a fixed window. For a trailing window use get_coingecko_token_market_chart; if you hold a CoinGecko id rather than an address use get_coingecko_coins_id_market_chart_range.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Asset platform ID (e.g., ethereum).

contract_address
string
required

Token contract address.

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

200 - application/json

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

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