Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

balances_<chain>.latest returns the most recent non-zero balance for every (address, token_address) pair. USD value is joined from prices.latest. Refreshed hourly. For historical balances use balances_<chain>.daily_updates. For block-level resolution use balances_<chain>.updates.

Table Schema

ColumnTypeDescription
blockchainvarcharChain identifier (e.g. ethereum)
addressvarbinaryAccount address
token_addressvarbinaryToken contract address. Native tokens use the standardized address from dune.blockchains (zero address on most EVMs, 0x0000…1010 on Polygon).
token_standardvarcharnative or erc20
token_symbolvarcharToken symbol from tokens_<chain>.erc20 (nullable)
balance_rawuint256Current balance in raw units (always > 0)
balancedoubleCurrent balance in display units (balance_raw / 10^decimals, falls back to 18 decimals when unknown)
balance_usddoublebalance * prices.latest.price. NULL when no price is available for that token; coalesce(balance_usd, 0) if you need to sum across mixed-coverage tokens.
block_numberbigintBlock of the most recent balance update
updated_attimestampBlock time of the most recent balance update

Example Queries

Current portfolio for a wallet, USD-sorted:
SELECT token_symbol, token_address, balance, balance_usd
FROM balances_ethereum.latest
WHERE address = 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
ORDER BY balance_usd DESC NULLS LAST
Top 50 holders of a token:
SELECT address, balance, balance_usd
FROM balances_ethereum.latest
WHERE token_address = 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 -- USDC
ORDER BY balance DESC
LIMIT 50
Native ETH locked in the WETH contract (equals current wrapped ETH supply):
SELECT balance AS eth_wrapped
FROM balances_ethereum.latest
WHERE address = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 -- WETH
  AND token_address = 0x0000000000000000000000000000000000000000 -- native ETH