Token Balances
This endpoint returns token balances for an address for any token that the address has interacted with
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
Column | Description | Type |
---|---|---|
request_time | Time of request | timestamp |
response_time | Time of response | timestamp |
wallet_address | Wallet address | string |
chain | Name of blockchain of token | string |
address | ERC20 contract address or blockchain name for native token | string |
amount | Amount of token owned in WEI | double |
symbol | Symbol of token, if avilable | string |
decimals | Decimals of token, if available | double |
price_usd | Current price of token, if available | double |
value_usd | Current value of token owned, if available | double |
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.
next_offset
to set the offset
parameter of the next page of results. Using your own offset
value will not have any effect.Headers
API key to access the service
Path Parameters
Wallet to get balances for
Query Parameters
Either 'all' or a comma separated list of chain ids to get balances for
Specify this to exclude spam tokens from the response
Specify ERC20
or NATIVE
to get only ERC20 tokens or native assets, respectively
A comma separated list of additional metadata fields to include for each token. Supported values: logo
, url
The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.
Maximum number of transactions to return
Response
Was this page helpful?