{"uid":"cap_okSx5St3_vclJMx9_STZh","slug":"ethereum-wallet-balance-checker-eth-erc-20-34369207","name":"Ethereum Wallet Balance Checker (ETH + ERC-20)","description":"Native ETH balance of a Ethereum wallet plus the balances of up to 20 ERC-20 tokens you list, formatted with each token's symbol and decimals, read live from Ethereum.","url":"https://onchaincheck.dev/eth/balances?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tokens":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40})(,0x[0-9a-fA-F]{40}){0,19}$","description":"Comma-separated ERC-20 contract addresses on Ethereum, up to 20"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address on Ethereum"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"eth","tokens":[{"raw":"37192124","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","balance":"37.192124","decimals":6},{"raw":"116800000000000","token":"0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984","symbol":"UNI","balance":"0.0001168","decimals":18}],"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","nativeSymbol":"ETH","nativeBalance":"5.773252986299759339"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9OgW-dcBv_kukaqjkRqB7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native ETH balance and balances of up to 20 specified ERC-20 tokens for an Ethereum wallet address, read live from the chain.","exampleAgentPrompt":"What's the current ETH balance and the USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and UNI (0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984) token balances for the Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?","exampleUseCases":[{"title":"DeFi portfolio snapshot before a trade","prompt":"Before I make any moves, can you pull the live ETH balance and USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48), WETH (0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2), and DAI (0x6B175474E89094C44Da98b954EedeAC495271d0F) balances for my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?"},{"title":"Verify airdrop receipt on Ethereum","prompt":"I'm expecting an ARB airdrop to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you check if the token 0xB50721BCf8d664c30412Cfbc6cf7a15145234ad1 has landed in that wallet yet on Ethereum?"},{"title":"Monitor whale wallet holdings","prompt":"I want to keep tabs on this whale — can you fetch the ETH balance plus holdings of USDT (0xdAC17F958D2ee523a2206206994597C13D831ec7) and SHIB (0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE) for the address 0x28C6c06298d514Db089934071355E5743bf21d60 on Ethereum?"}],"resultDescription":"A JSON object containing the wallet address, the chain identifier ('eth'), the native ETH balance as a human-readable string, and an array of token objects each with the contract address, symbol, decimals, raw balance, and decimal-formatted balance.","failureModes":["Invalid or malformed wallet address (not a 40-hex-char 0x address) returns an error","Invalid ERC-20 contract address in the tokens list returns an error or omits that token","Tokens list exceeds 20 addresses may be rejected or truncated","Ethereum node unavailability or rate limiting may cause timeouts","Non-contract address passed as a token address returns unexpected results"],"whenToPreferThis":"Use this endpoint when you need live, formatted ETH and ERC-20 balances for a specific Ethereum mainnet wallet — especially when you need multiple tokens in a single call (up to 20) with human-readable amounts including symbol and decimals. Prefer it over block explorer scraping or raw RPC calls for simplicity, and over Base or Polygon equivalents when the target chain is Ethereum mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:01:45.203Z","isFirstParty":false,"canonicalSlug":"ethereum-wallet-balance-checker-eth-erc-20-34369207"}