Tokens By Wallet

Fetches fungible tokens (native, ERC-20 and SPL) for multiple wallet addresses and networks. Returns a list of tokens with balances, prices, and metadata for each wallet/network combination. This endpoint is supported on Ethereum, Solana, and 30+ EVM chains. See the full list of supported networks here.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
addresseslist of objectsRequired
Array of wallet addresses and the networks to query them on. Maximum 2 addresses and maximum 5 networks per address.
withMetadatabooleanOptionalDefaults to true

Boolean - if set to true, returns metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

withPricesbooleanOptionalDefaults to true

Boolean - if set to true, returns token prices. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

includeNativeTokensbooleanOptionalDefaults to true

Whether to include each chain’s native token in the response (e.g. ETH on Ethereum). The native token will have a null contract address.

includeErc20TokensbooleanOptionalDefaults to true

Boolean - if set to true, returns ERC-20 tokens. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

pageKeystringOptional

Response

Successful response!
dataobject
List of tokens by address, with prices and metadata.

Errors