Skip to content

Get Native Token Balances by Account

This endpoint returns all Native Token Balances balances for a given list of accounts (supports pagination). Ownership and balances are only updated once the underlying transaction causing the change in ownership/balance is confirmed by the network (roughly ~10 minutes on all chains). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Looking for historical token data? Check out our historical_token_owners, historical_token_balances_by_account, and historical_native_token_balance_by_account endpoints to query balance and ownership data at a particular timestamp.


Parameter Description Type
chain_id A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query. string
account_addresses required The list of account addresses to retrieve balances for, separated by commas (max 100 addresses per request, supports ENS names). array of strings

curl -X GET \
    '' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.