{"uid":"cap_gB5sy3mWVtyeB0WtGq5PZ","slug":"ethereum-mainnet-eth-balance-eth-getbalance-9d216e96","name":"Ethereum Mainnet ETH Balance (eth_getBalance)","description":"ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.","url":"https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getbalance?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","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":{"type":"json","example":{"ok":true,"hex":"0x50122e9e75120cc5","chain":"ethereum","method":"eth_getBalance","result":5769725330718854000,"service":"x402_eth_reads_v1.eth_mainnet_eth_getbalance"}},"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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lcFxcVKrMDSeOAbNHbqN7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 for a given Ethereum mainnet address using eth_getBalance.","exampleAgentPrompt":"What's the current ETH balance of the Ethereum mainnet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Give me the result in wei.","exampleUseCases":[{"title":"Verify wallet ETH holdings before swap","prompt":"Before I do the token swap, can you check how much ETH is currently sitting in my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet?"},{"title":"Monitor treasury address balance","prompt":"Check the ETH balance of our DAO treasury at 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 on Ethereum mainnet — I want to know the exact amount in wei."},{"title":"Audit whale wallet before trade signal","prompt":"What's the ETH balance on Ethereum mainnet for address 0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503? I'm tracking large holders and need the raw wei figure."}],"resultDescription":"A JSON object containing: ok (boolean success flag), hex (balance in hexadecimal wei), result (numeric balance in wei), chain (chain identifier, e.g. 'base' or 'eth'), method ('eth_getBalance'), and service name string.","failureModes":["Invalid address format (not 0x + 40 hex) causes a validation error","Address with zero balance returns 0x0 hex and result: 0 — not an error","Network timeouts or RPC node unavailability may cause failed reads","Payment failure (x402 protocol) if USDC balance is insufficient for the $0.003 fee","Malformed request missing required address query param returns an error response"],"whenToPreferThis":"Choose this endpoint when you need a quick, paid, permissionless read of a native ETH balance on Ethereum mainnet without managing your own RPC node or API key. It is ideal for AI agents operating in x402 payment-capable environments that need on-chain data with minimal setup. Prefer this over self-hosted RPC calls when you want a metered, reliable mainnet read with a simple REST interface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:40:24.869Z","isFirstParty":false,"canonicalSlug":"ethereum-mainnet-eth-balance-eth-getbalance-9d216e96"}