{"uid":"cap_6aYqSETjVmgXWtezpBQ2T","slug":"balancepost-wallet-balance-on-base-0c16001b","name":"Balancepost — Wallet Balance on Base","description":"ETH and USDC balance of any address on Base, read live from the chain (eth_getBalance + USDC balanceOf) at request time. Pass ?address=0x... . Returns raw and decimal values plus the block number the read was made at. No third-party API, no cache.","url":"https://oraclepost.higgsfield.app/api/balance","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":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM address on Base, 0x-prefixed, 40 hex chars"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kNSKyvFcoZnBBOYOKxqQV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live ETH and USDC balances for any Base address, read directly from the chain with no caching or third-party APIs.","exampleAgentPrompt":"What's the current ETH and USDC balance on Base for wallet address 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97?","exampleUseCases":[{"title":"Pre-trade wallet funding check","prompt":"Before I execute this swap, check the live ETH and USDC balance on Base for 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I know if there are enough funds."},{"title":"Portfolio balance snapshot","prompt":"Can you pull the current ETH and USDC balances on Base for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 and tell me which block number the data was read at?"},{"title":"Agent treasury monitoring","prompt":"Check the on-chain balance of our agent's treasury wallet 0x1111000000000000000000000000000000001111 on Base — I need the exact raw and decimal ETH and USDC amounts straight from the chain."}],"resultDescription":"Returns the ETH balance in both raw wei and decimal format, the USDC balance in both raw (6-decimal integer) and human-readable decimal format, and the block number at which the read was performed — all fetched live from the Base chain via eth_getBalance and USDC balanceOf with no caching.","failureModes":["Invalid or malformed address (missing 0x prefix, wrong length) returns an error","Address with no on-chain activity returns zero balances (not an error)","RPC node unavailability causes request failure","Network congestion may slightly delay block reads","Payment of 0.001 USDC required per call via x402 protocol; missing payment results in 402 response"],"whenToPreferThis":"Choose this endpoint when you need a truly live, uncached, direct on-chain ETH and USDC balance for a Base address — particularly when accuracy at a specific block matters, when you distrust cached aggregators, or when you need both ETH and USDC in a single call. Prefer over third-party portfolio APIs when on-chain provenance and block-level precision are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T09:41:25.883Z","isFirstParty":false}