Skip to main content

v1/{chainName}/address/{walletAddress}/portfolio_v2/ REST API Endpoint

Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.

Updated on
Jan 09, 2025

v1/{chainName}/address/{walletAddress}/portfolio_v2/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The chain name eg: eth-mainnet
walletAddress
string
REQUIRED
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Query Parameters

quote-currency
string
The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP
days
integer
The number of days to return data for. Defaults to 30 days

Returns

data
object
The response data containing following fields:
address
string
The blockchain address for which data is retrieved
updated_at
string
The timestamp when the data was last updated
quote_currency
string
The currency used for quote values
chain_id
integer
The ID of the blockchain network
chain_name
string
The name of the blockchain network
items
array
An array of token balances and their historical holdings
contract_address
string
The address of the token contract
contract_decimals
integer
The number of decimals used by the token contract
contract_name
string
The name of the token contract
contract_ticker_symbol
string
The ticker symbol of the token contract
logo_url
string
The URL of the token's logo
holdings
array
An array of historical holdings data
quote_rate
integer
The current quote rate for the token in the specified currency
timestamp
string
The timestamp of the holding record
close
object
The closing balance and quote value for the token
balance
string
The closing balance of the token
quote
integer
The quote value of the token at close
pretty_quote
string
A formatted string of the quote value at close
high
object
The highest balance and quote value during the period (empty for this dataset)
low
object
The lowest balance and quote value during the period (empty for this dataset)
open
object
The opening balance and quote value during the period (empty for this dataset)
pagination
object
Pagination metadata for navigating through the data
has_more
boolean
Indicates if more pages are available
page_number
integer
The current page number
page_size
integer
The number of items per page
total_count
integer
The total number of items available
error
boolean
Indicates whether an error occurred
error_message
string
The error message if an error occurred, or null otherwise
error_code
string
The error code if an error occurred, or null otherwise
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/address/0x00000000219ab540356cbb839cbe05303d7705fa/portfolio_v2/' \
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