{"uid":"cap_4d079iKcx4uLHT_wv2GvV","slug":"code402-ethereum-address-balance-lookup-3ac7acc0","name":"code402 Ethereum Address Balance Lookup","description":"Deterministic compliance verification (IBAN, sanctions, onchain address) with XDR-1 signed receipts, plus Ethereum chain-data endpoints. Paid per call via x402 on Base (USDC).","url":"https://verify.code402.dev/v1/chain/balance/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object"}}},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"result":"string","network":"ethereum-mainnet"}}}}},"responseSchema":{"type":"json","example":{"result":"chain data","network":"ethereum"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M3SZlnjE1aUUNfOVYIoXW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the on-chain ETH balance for a given Ethereum address, paid per call via x402 on Base (USDC).","exampleAgentPrompt":"What's the current on-chain ETH balance for the Ethereum address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?","exampleUseCases":[{"title":"Compliance audit of wallet holdings","prompt":"Check the on-chain ETH balance of 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE — I need to verify its holdings as part of a KYC review."},{"title":"DeFi portfolio balance snapshot","prompt":"Pull the current Ethereum balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 so I can see how much ETH they're holding right now."},{"title":"Automated treasury monitoring","prompt":"Fetch the on-chain ETH balance for our treasury wallet 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 and tell me the current amount."}],"resultDescription":"Returns a JSON object containing chain data (the ETH balance or related on-chain data) and a network field identifying the network as Ethereum. The response reflects real-time on-chain state for the queried address.","failureModes":["Invalid or malformed Ethereum address returns an error response","Payment via x402 not completed results in 402 Payment Required","Address with no on-chain activity may return zero balance","Network congestion or RPC issues may cause delayed or failed responses","Rate limiting if payment flow is not properly handled"],"whenToPreferThis":"Choose this endpoint when you need a metered, pay-per-call on-chain Ethereum balance lookup without managing your own RPC infrastructure, especially in compliance or audit contexts where a paid, accountable data source is preferred. It is ideal for agents that already operate within the x402/Base USDC payment flow and need lightweight chain-data access alongside compliance verification capabilities from the same provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T06:32:48.143Z","isFirstParty":false,"canonicalSlug":"code402-ethereum-address-balance-lookup-3ac7acc0"}