Skip to main content

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

Commonly used to get the native token balance for an address. This endpoint is required because native tokens are usually not ERC20 tokens and sometimes you want something lightweight.

Updated on
Jan 09, 2025

v1/{chainName}/address/{walletAddress}/balances_native/ 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
block-height
integer
Ending block to define a block range. Omitting this parameter defaults to the latest block height

Returns

data
object
The response data containing following fields:
address
string
The blockchain address for which token data is retrieved
updated_at
string
The timestamp when the data was last updated
quote_currency
string
The currency used for quoting 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 balance 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 for the token
logo_url
string
The URL of the token's logo
block_height
integer
The height of the block where the token balance was retrieved
balance
string
The token balance associated with the address
quote_rate
integer
The quoted rate of the token in the specified currency
quote
integer
The quoted value of the token balance in the specified currency
pretty_quote
string
A formatted string of the quoted value of the token balance
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/0xdAC17F958D2ee523a2206206994597C13D831ec7/balances_native/' \
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