Skip to main content

v1/allchains/address/{walletAddress}/balances/ REST API Endpoint

Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.

Updated on
Jan 09, 2025

v1/allchains/address/{walletAddress}/balances/ REST API Endpoint

Path Parameters

walletAddress
string
REQUIRED
The wallet address to fetch token balances for

Query Parameters

chains
string
A comma-separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains
limit
integer
The maximum number of token balances to return per page, up to 100
before
string
Pagination cursor pointing to fetch token balances before a certain point in time
cutoff-timestamp
integer
The timestamp to filter balances updated before this time
quote-currency
string
The currency in which to return token quotes

Returns

data
object
The main container for the asset data
updated_at
string
The timestamp when the data was last updated
cursor_before
string
Cursor pointing to the position before the current page of data
quote_currency
string
The currency used for quoting values
items
array
A list of asset items
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
contract_address
string
The address of the token contract
supports_erc
array
A list of supported ERC standards
contract_display_name
string
The display name of the token contract
logo_urls
object
URLs of logos associated with the token
token_logo_url
string
The URL of the token's logo
protocol_logo_url
string
The URL of the protocol's logo, if available
chain_logo_url
string
The URL of the chain's logo
last_transferred_at
string
The timestamp of the last transfer involving the token
type
string
The type of asset (e.g., cryptocurrency or dust)
is_spam
boolean
Indicates whether the asset is flagged as spam
balance
string
The current balance of the token
balance_24h
string
The balance of the token 24 hours ago
quote_rate
number
The quoted rate of the token in the specified currency
quote_rate_24h
number
The quoted rate of the token 24 hours ago in the specified currency
quote
number
The current value of the token in the specified currency
pretty_quote
string
A formatted string of the current token value
quote_24h
number
The token value 24 hours ago in the specified currency
pretty_quote_24h
string
A formatted string of the token value 24 hours ago
chain_id
string
The ID of the blockchain network
chain_name
string
The name of the blockchain network
chain_display_name
string
The display name of the blockchain network
is_native_token
boolean
Indicates if the token is the native token of the blockchain
error
boolean
Indicates if an error occurred during the request
error_message
string
The error message, if applicable
error_code
integer
The error code, if applicable
Request
1
curl --location 'https://api.covalenthq.com/v1/allchains/address/0x091ae21649442cf75B146b83aD5782e14528d4cf/balances/?chains=eth-mainnet&limit=10' \
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