Get historical token prices

Commonly used to get historic prices of a token between date ranges. Supports native tokens.

^{Credit Cost: 1 per call.
Processing: Batch}

Path Parameters

chainName

string

required

The chain name eg: eth-mainnet.

quoteCurrency

string

required

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.

contractAddress

string

required

Contract address for the token. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically. Supports multiple contract addresses separated by commas.

Query Parameters

from

string

The start day of the historical price range (YYYY-MM-DD).

to

string

The end day of the historical price range (YYYY-MM-DD).

prices-at-asc

boolean

Sort the prices in chronological ascending order. By default, it's set to false and returns prices in chronological descending order.

Response

200 - application/json

contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

contract_name

string

The string returned by the name() method.

contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items

object[]

List of response items.

logo_url

string

The contract logo URL.

logo_urls

object

The contract logo URLs.

Show child attributes

logo_urls.chain_logo_url

string

The chain logo URL.

logo_urls.protocol_logo_url

string

The protocol logo URL.

logo_urls.token_logo_url

string

The token logo URL.

prices

object[]

List of response items.

Show child attributes

prices.contract_metadata

object

Show child attributes

prices.contract_metadata.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

prices.contract_metadata.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

prices.contract_metadata.contract_name

string

The string returned by the name() method.

prices.contract_metadata.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

prices.contract_metadata.logo_url

string

The contract logo URL.

prices.contract_metadata.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

prices.date

string

The date of the price capture.

prices.pretty_price

string

A prettier version of the price for rendering purposes.

prices.price

number

The price in the requested quote-currency.

quote_currency

string

The requested quote currency eg: USD.

supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

update_at

string