Multi-Contract Dashboard Aggregator

WHAT IT DOES

Multi-Contract Dashboard Aggregator takes a list of contract addresses and a dashboard address, then fetches all on-chain balances and holdings from those contracts in a single batch. It reads native ETH balances, ERC-20 token balances, ERC-721 NFT collection counts, and ERC-1155 multi-token holdings across up to 50 contracts per batch. The tool automatically detects the contract type for each address by attempting to call standard interface functions—it tries ERC-20 first, then ERC-721, then ERC-1155—and presents a unified dashboard showing every balance and holding in one place. It displays the contract name, symbol, balance amounts (formatted with the correct decimals for ERC-20 tokens), and NFT counts. The tool also shows summary statistics including total native ETH, number of ERC-20 tokens detected, number of NFT collections, and total NFT count. This is ideal for portfolio managers, DeFi users tracking multiple protocol positions, NFT collectors, or anyone who wants a quick snapshot of what a wallet holds across many different contracts.

HOW TO USE

Connect your wallet or enter a dashboard address manually. Enter a list of contract addresses—one per line—in the textarea. These can be any EVM contracts: tokens, NFT collections, DeFi protocol contracts, or custom contracts. Click "Aggregate Dashboard." The tool sequentially queries each contract on the selected network. For each address, it attempts to call balanceOf on the dashboard address. If the call succeeds and returns a non-zero balance, the tool checks for additional metadata like decimals, symbol, and name. If a contract fails the ERC-20 check, the tool automatically tries ERC-721 balanceOf, and then ERC-1155 balanceOf. The results are displayed as a clean dashboard with summary cards at the top showing total native ETH, number of ERC-20 tokens found, number of NFT collections, and total NFT count. Below the summary, each contract with a non-zero balance appears as a card showing its type, name, symbol, and the exact balance or count. The tool does not require any prior knowledge of the contract types—it detects them automatically at runtime.

THE REAL MECHANISM

The tool does not rely on external APIs, indexers, or pre-indexed data. It uses the connected Ethereum provider to make direct eth_call RPC requests to the chain. For each contract address, the tool instantiates a minimal ethers.js interface with the ERC-20 ABI and calls balanceOf(dashboardAddress). If this succeeds, it then calls decimals() and symbol() for formatting. If balanceOf reverts or returns zero, the tool considers the contract might be an NFT collection. It then instantiates an ERC-721 interface and calls balanceOf again. If that succeeds and returns a positive number, the tool classifies it as ERC-721 and fetches name and symbol. If both fail, the tool attempts ERC-1155 balanceOf with token ID 0 as a heuristic for multi-token contracts. This tiered approach ensures the tool correctly identifies token standards without requiring the user to specify types. The tool processes contracts sequentially rather than in parallel to avoid rate-limiting issues with public RPCs. All data is fetched in real-time, so the dashboard always reflects the current on-chain state for the given block. Native ETH balance is fetched using provider.getBalance, which returns the wei amount, then formatted to ether.

WHAT IT CANNOT SEE

This tool cannot aggregate across more than 50 contracts per batch due to RPC response size limits and to prevent timeout issues. It cannot detect off-chain data like token metadata, USD prices, historical balances, or transaction history. It cannot track internal transactions or contract state changes beyond what is queryable via eth_call. The tool cannot read from non-EVM chains or contracts that are not deployed on the selected network. It cannot estimate gas or simulate complex multi-call sequences beyond what the RPC supports. The tool does not verify that the contracts match their claimed standards—if a contract incorrectly implements balanceOf, the tool may misclassify it. It cannot detect ERC-777 tokens or other non-standard token types. It cannot see token approvals, allowances, or any access control data. The tool does not identify proxy implementations, so if you pass a proxy address, it will show the proxy's balanceOf, which may delegate to an implementation contract automatically. It cannot detect token transfers, events, or any historical activity.

PLEASE NOTE

Multi-Contract Dashboard Aggregator works exclusively with Ethereum Virtual Machine (EVM) compatible chains including Ethereum, Goerli, Sepolia, Polygon, BSC, Arbitrum, Optimism, Avalanche, and others. The tool requires the contracts to be deployed on the selected network and for the RPC node to support eth_call and eth_getCode. It reads data only and does not send any transactions or modifications to the blockchain. All processing occurs client-side in your browser; no data is sent to any external server. The tool is free to use and does not require authentication. For best results, use contracts that follow the standard ERC-20, ERC-721, and ERC-1155 interfaces.