{"uid":"cap_FpK34J13735evkQiE_iBT","slug":"eth-balance-lookup-by-address-920f6313","name":"ETH Balance Lookup by Address","description":"Native ETH balance (eth_getBalance) of any 0x wallet address on Ethereum at the latest block, in wei and in ETH. Use to check whether a wallet can pay gas or a transfer; for ERC-20 tokens use eth_token_balance, for all holdings at once use wallet_portfolio. A malformed address is rejected with 400, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"0x wallet or contract address"}}},"responseSchema":{"type":"object","properties":{"block":{"type":"number"},"chain":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"balance":{"type":"string"},"chainId":{"type":"number"},"balanceWei":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Zd4Ttcq6b5tQrt8YligRh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ETH balance of a given wallet or contract address on Ethereum, including both human-readable and raw Wei amounts.","exampleAgentPrompt":"What's the current ETH balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?","exampleUseCases":[{"title":"Monitor whale wallet ETH holdings","prompt":"Check the ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 and tell me how much ETH they currently hold."},{"title":"Verify smart contract ETH reserves","prompt":"Can you look up how much ETH is sitting in the Uniswap v3 router contract at 0xE592427A0AEce92De3Edee1F18E0157C05861564?"},{"title":"Confirm wallet funded before transfer","prompt":"Before I send a transaction, check whether 0xAbCd1234...5678 has enough ETH — what's the current balance?"}],"resultDescription":"Returns a JSON object with the ETH balance as a human-readable decimal string, the raw balance in Wei, the block number at which the balance was read, the chain name (e.g. 'Ethereum'), the chainId (e.g. 1), the queried address, and the symbol ('ETH').","failureModes":["Invalid or malformed 0x address returns an error response","Address with zero balance returns balance='0' and balanceWei='0' (not an error)","Network timeouts or RPC node failures may cause transient errors","No charge is applied for failed calls per x402 protocol"],"whenToPreferThis":"Use this endpoint when you need a quick, no-account, pay-per-call ETH balance check on Ethereum mainnet for any wallet or contract address. It is ideal for AI agents that need on-chain balance data without managing API keys, and when cost predictability at $0.001 per call matters. Prefer alternatives if you need balances across multiple chains simultaneously or ERC-20 token balances rather than native ETH.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:09:55.695Z","isFirstParty":false,"canonicalSlug":"eth-balance-lookup-by-address-920f6313"}