{"uid":"cap_qUUnsnlF7L35QvHcqDqk4","slug":"ethereum-mainnet-eth-balance-lookup-eth-getbalance-d7b1ecd0","name":"Ethereum Mainnet ETH Balance Lookup (eth_getBalance)","description":"","url":"https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_getbalance?utm_source=zero.xyz","method":"POST","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x + 40 hex"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lVapxiuEDd2e-pQPCgqWK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 (in wei) of a given Ethereum address at the latest block via eth_getBalance JSON-RPC.","exampleAgentPrompt":"What's the current ETH balance of the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Give me the raw wei amount from Ethereum mainnet.","exampleUseCases":[{"title":"Portfolio ETH balance check","prompt":"Can you look up how much ETH is sitting in my wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Ethereum mainnet right now?"},{"title":"Verify wallet funding before transaction","prompt":"Before I proceed, can you check whether the wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e has any ETH balance on Ethereum mainnet?"},{"title":"Monitor whale wallet ETH holdings","prompt":"Check the current ETH balance of the known whale address 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 on Ethereum mainnet — give me the exact wei amount."}],"resultDescription":"A JSON-RPC response containing the ETH balance of the queried address in wei (hexadecimal or decimal string), reflecting the state at the latest Ethereum mainnet block. The agent receives the raw on-chain balance suitable for further conversion or display.","failureModes":["Invalid address format (not 0x + 40 hex) — request rejected or error response","Address has zero balance — returns 0 wei, not an error","Network or node timeout — service temporarily unavailable","Payment failure in USDC on Base — call not executed","Rate limiting if many rapid successive calls"],"whenToPreferThis":"Choose this endpoint when you need a quick, single-address native ETH balance read on Ethereum mainnet with pay-per-call micropayment billing (no API key required, USDC on Base). Prefer it over node providers requiring subscriptions when your agent needs lightweight, on-demand balance checks without managing RPC credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T18:28:06.541Z","isFirstParty":false,"canonicalSlug":"ethereum-mainnet-eth-balance-lookup-eth-getbalance-d7b1ecd0"}