GET
/
echo
/
v1
/
balances
/
evm
/
{address}

The Token Balances API provides accurate and fast real time balances of the native and ERC20 tokens of accounts on supported EVM blockchains. Data is typically available within 100 ms since a block was propagated to nodes. The endpoint only returns balances for certain low latency chains by default. To fetch balances for all supported chains please pass the chain_ids=all parameter. See EVM Supported Chains for more details.

  • These endpoints are authenticated with a normal Dune API key.
  • Specify ?filters=erc20 or ?filters=native to get only erc20 tokens or native assets, respectively
  • Specify ?exclude_spam_tokens to filter out tokens Dune believes to be spam. We use this query to determine if something is spam.
  • Specify ?chain_ids=all to fetch balances for all supported chains.
  • Specify ?chain_ids=11,250,1 to fetch balances only for select chains. See chainlist https://chainlist.org/ for a list of chainIDs.
  • Specify ?metadata=url,logo to get url and logo for tokens.
  • CoinMarketCap is used for price information
  • Token metadata, such as symbols and decimals, are fetched from Dune’s tokens.erc20 dataset which is curated by Dune users and defined.fi

Column Descriptions

ColumnDescriptionType
request_timeTime of requesttimestamp
response_timeTime of responsetimestamp
wallet_addressWallet addressstring
chainName of blockchain of tokenstring
addressERC20 contract address or blockchain name for native tokenstring
amountAmount of token owned in WEIdouble
symbolSymbol of token, if avilablestring
decimalsDecimals of token, if availabledouble
price_usdCurrent price of token, if availabledouble
value_usdCurrent value of token owned, if availabledouble

Pagination

This endpoint is using cursor based pagination. You can use the limit parameter to define the maximum page size. Results might at times be less than the maximum page size. The next_offset value is passed back by the initial response and can be used to fetch the next page of results, by passing it as the offet query parameter in the next request.

You can only use the value from next_offset to set the offset parameter of the next page of results. Using your own offset value will not have any effect.

Headers

X-Dune-Api-Key
string
required

API key to access the service

Path Parameters

address
string
required

Wallet to get balances for

Query Parameters

chain_ids
string | null

Either 'all' or a comma separated list of chain ids to get balances for

exclude_spam_tokens
string | null

Specify this to exclude spam tokens from the response

filters
string | null

Specify ERC20 or NATIVE to get only ERC20 tokens or native assets, respectively

metadata
string | null

A comma separated list of additional metadata fields to include for each token. Supported values: logo, url

offset
string | null

The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.

limit
integer | null

Maximum number of transactions to return

Required range: x > 0

Response

200 - application/json
balances
object[]
required
response_time
string
required
wallet_address
string
required
errors
object
next_offset
string | null
request_time
string | null