Balance Fetcher

WHAT IT DOES

Balance Fetcher reads the user's current wallet address and network chain ID from the connected wallet, reads ETH and native token balances via eth_getBalance, reads ERC-20 token balances via eth_call to token contracts, optionally reads token prices via a price oracle or DEX, and optionally reads transaction history and token holdings via eth_getLogs and eth_getTransactionCount. The tool takes any Ethereum address and returns its complete balance snapshot: the native token balance (ETH or chain-specific gas token) and balances for common ERC-20 tokens. It displays both raw token amounts and approximate USD values using embedded price estimates for major tokens. The tool can also optionally fetch the transaction count for the address to indicate activity level.

HOW TO USE

Connect your existing wallet using the "Connect" button — this establishes the wallet bridge and displays your current address, chain ID, and ETH balance. Enter any Ethereum address (0x...) into the input field and click "Fetch Balances". The tool retrieves the native token balance via eth_getBalance, then queries a set of common ERC-20 token contracts using eth_call to get balances. Results are displayed in a clear table showing each token's symbol, raw balance, and estimated USD value. The tool also calculates and displays a total portfolio value. The address field defaults to your connected wallet address for convenience, but you can paste any address.

MECHANISM — DIRECT ON-CHAIN BALANCE QUERY WITH PRICE ESTIMATION

This tool uses a dual-layer balance query approach. For the native token, it uses eth_getBalance, which returns the raw wei value, then formats it using ethers.utils.formatEther. For ERC-20 tokens, the tool instantiates a contract interface using the standard ERC-20 ABI with the balanceOf function, then calls it with the target address. The tool queries a curated list of common tokens (USDC, USDT, DAI, WBTC, UNI, LINK, AAVE, MATIC) but does not hardcode token addresses as the only source — the person can extend the list by modifying the tokenAddresses array if they wish. For price estimation, the tool uses a simple embedded price map for major tokens; for tokens without a price, it displays "—" in the USD column. The transaction count is fetched via eth_getTransactionCount to indicate if the address has any on-chain activity.

WHAT IT CANNOT SEE

This tool cannot fetch balances for addresses on non-EVM chains. It cannot retrieve token prices without an external price source. It cannot read balances for tokens that do not implement the standard ERC-20 balanceOf function. It cannot determine if an address is active or abandoned. It cannot fetch balances for addresses that have never transacted (balance will be zero). It cannot guarantee that the displayed token list is complete without scanning all token transfer events. It cannot read balances from contracts that require authentication or are not publicly readable. It cannot detect if tokens are locked, staked, or otherwise inaccessible to the address.

PLEASE NOTE

EVM chains only — supports Ethereum mainnet and all EVM-compatible networks. This tool requires a real EVM wallet extension (such as MetaMask) to provide a provider for reading on-chain data. The tool is read-only and never signs or broadcasts transactions. Price estimates are approximate and should not be used for trading decisions. Token discovery is limited to a predefined list of common tokens; for a complete token portfolio, you would need to scan all token transfer events, which is beyond the scope of this simple fetcher.