Skip to main content

v1/pricing/historical_by_addresses_v2/eth/{quoteCurrency}/{contractAddress}/ REST API Endpoint

Get historic prices of a token between date ranges. Supports native tokens.

Updated on
Jan 09, 2025

v1/pricing/historical_by_addresses_v2/eth/{quoteCurrency}/{contractAddress}/ REST API Endpoint

Path Parameters

chainName
string
The blockchain name for which data is being queried (e.g., eth, bsc, etc.)
quoteCurrency
string
The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP
contractAddress
string
The contract address of the token being queried

Query Parameters

from
string
The start date for fetching historical prices in YYYY-MM-DD format
to
string
The end date for fetching historical prices in YYYY-MM-DD format
prices-at-asc
boolean
Whether to sort the prices in ascending order by timestamp

Returns

data
array
The array containing token contract details and price information
contract_decimals
integer
The number of decimals the token uses
contract_name
string
The name of the token contract
contract_ticker_symbol
string
The ticker symbol of the token
contract_address
string
The address of the token contract
supports_erc
array
The supported ERC standards for the token (e.g., ERC20)
logo_url
string
The URL for the token's logo
update_at
string
The timestamp when the data was last updated
quote_currency
string
The currency in which the prices are quoted
logo_urls
object
An object containing various logo URLs
token_logo_url
string
The URL for the token's logo
protocol_logo_url
string
The URL for the protocol's logo (if available)
chain_logo_url
string
The URL for the chain's logo
prices
array
An array of price data for the token
contract_metadata
object
Metadata of the token contract
contract_decimals
integer
The number of decimals the token uses
contract_name
string
The name of the token contract
contract_ticker_symbol
string
The ticker symbol of the token
contract_address
string
The address of the token contract
supports_erc
array
The supported ERC standards for the token (e.g., ERC20)
logo_url
string
The URL for the token's logo
date
string
The date for the price data
price
integer
The price of the token on the specified date
pretty_price
string
A human-readable representation of the token price
items
array
An array of item data related to the token
contract_metadata
object
Metadata of the token contract
contract_decimals
integer
The number of decimals the token uses
contract_name
string
The name of the token contract
contract_ticker_symbol
string
The ticker symbol of the token
contract_address
string
The address of the token contract
supports_erc
array
The supported ERC standards for the token (e.g., ERC20)
logo_url
string
The URL for the token's logo
date
string
The date for the item data
price
integer
The price of the token on the specified date
pretty_price
string
A human-readable representation of the token price
error
boolean
Indicates whether there was an error in the response
error_message
string
The error message, if any
error_code
integer
The error code, if any
Request
1
curl --location 'https://api.covalenthq.com/v1/pricing/historical_by_addresses_v2/eth-mainnet/USD/0x4052510A03e6D5e965441c6E6Fe3395a73D389f6/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free