Skip to main content

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

Fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata

Updated on
Jan 09, 2025

v1/{chainName}/address/{walletAddress}/balances_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 in which token values should be quoted
nft
boolean
Whether to include NFTs in the response
no-nft-fetch
boolean
Whether to exclude fetching NFT-related data
no-spam
boolean
Whether to exclude spam tokens from the response
no-nft-asset-metadata
boolean
Whether to exclude NFT asset metadata from the response

Returns

data
object
The response data containing following fields:
address
string
The wallet address for which the data is returned
chain_id
integer
The unique identifier of the blockchain network
chain_name
string
The name of the blockchain network
quote_currency
string
The currency used to quote the token values
updated_at
string
The timestamp when the data was last updated
items
array
An array of token balances or assets associated with the address
contract_decimals
integer
The number of decimals used in the token's contract
contract_name
string
The name of the token's contract
contract_ticker_symbol
string
The ticker symbol of the token
contract_address
string
The contract address of the token
contract_display_name
string
The display name of the token
supports_erc
string
A list of ERC standards supported by the token
logo_url
string
The URL of the token's logo
logo_urls
object
The object containing different logo URLs for the token
token_logo_url
string
The URL of the token's logo
protocol_logo_url
string
The URL of the protocol's logo
chain_logo_url
string
The URL of the chain's logo
last_transferred_at
string
The timestamp when the token was last transferred
native_token
boolean
Whether the token is the native token of the blockchain
type
string
The type of the token, such as fungible or non-fungible
is_spam
boolean
Whether the token is flagged as spam
balance
string
The current balance of the token
balance24h
string
The balance of the token 24 hours ago
quote_rate
integer
The current price of the token in the quote currency
quote_rate24h
integer
The price of the token in the quote currency 24 hours ago
quote
integer
The current value of the token in the quote currency
quote24h
integer
The value of the token in the quote currency 24 hours ago
pretty_quote
string
The formatted current value of the token
pretty_quote24h
string
The formatted value of the token 24 hours ago
protocol_metadata
object
The metadata related to the protocol associated with the token
protocol_name
string
The name of the protocol
nft_data
array
An array of data related to NFTs
token_id
string
The unique identifier of the NFT
token_balance
string
The balance of the NFT token
token_url
string
The URL of the NFT's metadata
supports_erc
string
A list of ERC standards supported by the NFT
token_price_wei
string
The price of the NFT in wei
token_quote_rate_eth
string
The price of the NFT quoted in Ether
original_owner
string
The address of the NFT's original owner
external_data
object
The metadata associated with the NFT, such as its attributes and image URLs
name
string
The name of the NFT
desc
string
The description of the NFT
image
string
The URL of the NFT's image
image256
string
The URL of the NFT's 256px image
image512
string
The URL of the NFT's 512px image
image1024
string
The URL of the NFT's 1024px image
animation_url
string
The URL of the NFT's animation
external_url
string
The external URL of the NFT
attributes
array
An array of attributes describing the NFT
trait_type
string
The type of the NFT trait
value
string
The value of the NFT trait
thumbnails
object
The object containing various thumbnail images of the NFT
image256
string
The URL of the 256px thumbnail
image512
string
The URL of the 512px thumbnail
image1024
string
The URL of the 1024px thumbnail
image_opengraph_url
string
The OpenGraph URL of the NFT's image
thumbhash
string
The thumbhash of the NFT's image
image_preview
string
The URL of the preview image of the NFT
asset_properties
object
The metadata of the NFT's asset, including dimensions and dominant color
asset_width
integer
The width of the NFT's asset
asset_height
integer
The height of the NFT's asset
dominant_color
string
The dominant color of the NFT's asset
owner
string
The address of the current owner of the NFT
owner
string
The address of the current owner of the NFT
owner_address
string
The wallet address of the NFT's current owner
burned
boolean
Whether the NFT has been burned
pagination
object
The pagination details for the response
has_more
boolean
The flag indicating if there are more pages of data
page_number
integer
The current page number
page_size
integer
The number of items per page
total_count
integer
The total number of items (nullable)
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/0x9690C8c169dd8FC15d75593048E4c453B7CC451c/balances_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