{"uid":"cap_VlSexaBJXFXjJEHEoeGes","slug":"soren-eth-balance-reader-544a3ad8","name":"Soren ETH Balance Reader","description":"Read the native ETH balance of any Base address, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable.","url":"https://soren.com/v1/chain/balance","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","examples":["0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd"],"description":"The 0x… address to read."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.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_xueq9k_aVXQQOHCtzWP9X","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 of any Base mainnet address, live at call time, stamped with the block number it was read from.","exampleAgentPrompt":"What's the current native ETH balance on Base mainnet for the address 0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd?","exampleUseCases":[{"title":"Check wallet ETH before a transaction","prompt":"Before I send that transaction, can you check the live ETH balance on Base for 0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd to make sure it has enough for gas?"},{"title":"Monitor treasury wallet balance","prompt":"What is the current ETH balance on Base mainnet for our treasury wallet at 0x1234567890abcdef1234567890abcdef12345678?"},{"title":"Verify funded smart contract","prompt":"Can you confirm that the contract at 0xAbCd1234567890EFAbCd1234567890EFAbCd1234 actually has ETH in it on Base mainnet right now?"}],"resultDescription":"Returns the native ETH balance of the queried address as read from Base mainnet at the moment of the call, along with the block number the read was stamped against. The balance is returned in wei and typically includes a formatted representation.","failureModes":["Invalid or malformed address (not a valid 0x… hex address) returns an error","Network or RPC unavailability on Base mainnet may cause a transient failure","Payment (x402) failure if wallet has insufficient USDC results in no charge and no data","Address not found is not a failure — zero balance is returned for unfunded addresses"],"whenToPreferThis":"Use this endpoint when you need a live, real-time native ETH balance from Base mainnet for any address with no API key or account setup required. Prefer this over RPC node providers when you want pay-per-call pricing with no subscription. Choose the attested /v1/oracle/onchain variant if you need a cryptographically signed proof of the balance; use this endpoint for lightweight, fast, cheap balance checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:18.251Z","isFirstParty":false}