Get multichain balances

GET

allchains

address

{walletAddress}

balances

^{Credit Cost: 2.5 per call.}
^{Processing: Realtime}

Base cost is 2.5 credits (including requests that return with status 200 but no items) for the first page.

Subsequent pages cost 1 credit.

All EVM chains are supported. When no chains are specified, the Foundational Chains are passed as default.

Domain names (e.g. demo.eth) are not supported.

The UNIX cutoff-timestamp retrieves the token balance snapshot from the nearest block before the specified timestamp.

Balances presented in descending order of the fiat quote value for most major tokens. Minor tokens may be presented in descending order of their last_transferred_at timestamp.

Path Parameters

walletAddress

string

required

The requested address. Domain names (e.g. demo.eth) NOT supported.

Query Parameters

chains

string

Comma separated list of chain names or IDs to retrieve token balances from. Defaults to all foundational chains.

limit

integer

Number of token balances to return per page, up to the default max of 100 items.

before

string

Pagination cursor pointing to fetch token balances before a certain point.

cutoff-timestamp

integer

UNIX timestamp to retrieve the balance snapshot from the nearest block before the specified cutoff time.

quote-currency

string

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

Response

200 - application/json

updated_at

string

Timestamp for when the data was last updated.

cursor_before

string

Pagination cursor pointing to the previous page.

quote_currency

string

The requested quote currency eg: USD.

items

object[]

List of token balances returned by the API.

items.contract_decimals

integer

Use contract decimals to format the balance for display purposes - divide the balance by 10^{contract_decimals}.

items.contract_name

string

The string returned by the name() method.

items.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.contract_display_name

string

A display-friendly name for the contract.

items.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.logo_urls

object

The contract logo URLs.

items.last_transferred_at

string

The timestamp when the token was transferred.

items.is_native_token

boolean

Indicates if a token is the chain's native gas token, eg: ETH on Ethereum.

items.type

string

One of cryptocurrency, stablecoin, nft or dust.

items.is_spam

boolean

Denotes whether the token is suspected spam.

items.balance

string

b;The asset balance. Use contract_decimals to scale this balance for display purposes.

items.balance24h

string

b;The 24h asset balance. Use contract_decimals to scale this balance for display purposes.

items.quote_rate

number

The exchange rate for the requested quote currency.

items.quote_rate24h

number

The 24h exchange rate for the requested quote currency.

items.quote

number

The current balance converted to fiat in quote-currency.

items.quote24h

number

The 24h balance converted to fiat in quote-currency.

items.pretty_quote

string

A prettier version of the quote for rendering purposes.

items.pretty_quote24h

string

A prettier version of the 24h quote for rendering purposes.

items.chain_id

integer

The chain ID that this balance is on. eg: 1.

items.chain_name

string

The chain name that this balance is on. eg: eth-mainnet.

items.chain_display_name

string

A display-friendly name for the chain.

Get activity across all chains for address Get multichain & multiaddress transactions

API Reference

Cross Chain

Balances

Transactions

NFT

Security

Bitcoin

Utility

Path Parameters

Query Parameters

Response