{"uid":"cap_xiV1sQzwvhA-5Hg4j9D18","slug":"x402-agent-hub-native-coin-balance-3c03b162","name":"x402 Agent Hub – Native Coin Balance","description":"Native coin balance of any address on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC or Avalanche, with raw wei and formatted units plus the block it was read at. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","url":"https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/balance?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base (default), ethereum, arbitrum, optimism, polygon, bsc or avalanche. Chain IDs also accepted."},"address":{"type":"string","description":"0x-prefixed wallet or contract address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","address":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072","balance":{"raw":"1250000000000000","symbol":"ETH","decimals":18,"formatted":"0.00125"},"chainId":8453,"blockNumber":38211554}},"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_IzgX9_rDvkdPTM7Zk7AkW","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 coin balance (raw wei and formatted) of any wallet or contract address on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, or Avalanche, along with the block number at which it was read.","exampleAgentPrompt":"What's the current ETH balance of 0x1721E9841257A34DbDBA407D4DBA3a727a02d072 on Base — give me both the raw wei and the formatted amount?","exampleUseCases":[{"title":"Portfolio balance check on Base","prompt":"Check how much ETH is sitting in wallet 0xAbc123...def456 on Base right now, and tell me the formatted amount as well as the block it was read at."},{"title":"DeFi contract liquidity snapshot","prompt":"What's the current native MATIC balance held by the contract at 0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9 on Polygon? I need the raw wei and the human-readable amount."},{"title":"Multi-chain wallet audit","prompt":"Can you look up the ETH balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Arbitrum and also on Optimism so I can compare what's on each chain?"}],"resultDescription":"A JSON object containing the chain name, queried address, balance in raw wei, symbol (e.g. ETH, MATIC, BNB), decimals, formatted balance string, chain ID, and the block number at which the balance was read.","failureModes":["Invalid or malformed address (not 0x-prefixed or wrong length) — settlement cancelled, no charge","Unsupported chain name or chain ID — request rejected, settlement cancelled","RPC or upstream node error on the target chain — settlement cancelled, no charge","Rate limiting or quota exhaustion on the underlying RPC provider"],"whenToPreferThis":"Choose this endpoint when you need the native coin balance (ETH, MATIC, BNB, AVAX, etc.) of an address on one of the 7 supported EVM chains and want both raw wei and human-readable formatted output in a single call. Prefer this over ERC-20 balance endpoints when dealing with the chain's native asset, not a token contract. The pay-per-successful-read model (errors are not charged) makes it low-risk for validation or exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T12:32:42.695Z","isFirstParty":false,"canonicalSlug":"x402-agent-hub-native-coin-balance-3c03b162"}