latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

get-token-balances-for-address

Commonly used to fetch the native and fungible (ERC20) tokens held by an address. Response includes spot prices and other metadata.

get/v1/{chainName}/address/{walletAddress}/balances_v2/

Path parameters

chainNamestring required

The chain name eg: eth-mainnet.

walletAddressstring required

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

Query parameters

quote-currencystring

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.

no-spamboolean

If true, the suspected spam tokens are removed. Supported on all Foundational Chains.

Response

Successful response

addressstring

The requested address.

chain_idinteger

The requested chain ID eg: 1.

chain_namestring

The requested chain name eg: eth-mainnet.

chain_tip_heightinteger

The latest block height of the blockchain at the time this response was provided.

chain_tip_signed_atstring date-time

The timestamp of the latest signed block at the time this response was provided.

quote_currencystring

The requested quote currency eg: USD.

updated_atstring date-time

The timestamp when the response was generated. Useful to show data staleness to users.