{"uid":"cap_7sTYNPgfQkx_EwHmymzDq","slug":"native-coin-balance-lookup-eth-pol-via-eth-getbalance-abffba6b","name":"Native Coin Balance Lookup (ETH/POL) via eth_getBalance","description":"Use when you need the native coin balance (ETH, or POL on Polygon) of an address on Base, Ethereum, Arbitrum, Optimism or Polygon, read live via eth_getBalance. Returns exact wei and decimal value with the block it was read at.","url":"https://biosfera.46-62-215-147.sslip.io/o/native-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":["chain","address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_DYICxoRQe17q4XXGT57po","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 the exact native coin balance (ETH or POL) of a wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, in both raw wei and decimal form with the block number at which it was read.","exampleAgentPrompt":"What's the current ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet — give me both the exact wei amount and the readable decimal value?","exampleUseCases":[{"title":"Pre-transaction ETH sufficiency check","prompt":"Before I send a transaction, can you check whether 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B has enough ETH on Arbitrum to cover the cost — fetch its current native balance in wei and decimal?"},{"title":"Portfolio native balance monitoring","prompt":"What's the current POL balance of 0x1234567890abcdef1234567890abcdef12345678 on Polygon right now, and which block was that read from?"},{"title":"DeFi protocol liquidity audit","prompt":"Can you look up the native ETH balance sitting in the contract at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Base mainnet and tell me both the wei value and the human-readable amount?"}],"resultDescription":"Returns the wallet's native coin balance as an exact integer in wei, a decimal representation (e.g. 1.234 ETH), and the block number at which the balance was read. The coin unit depends on the chain (ETH for Base/Ethereum/Arbitrum/Optimism, POL for Polygon).","failureModes":["Invalid address format (not a 0x + 40 hex chars) returns a validation error","Unsupported chain value outside the allowed enum returns a 400-style error","Node connectivity issues or RPC downtime may cause transient failures","Very recently created addresses may return zero balance correctly, not an error","Missing required query parameters (chain or address) returns a schema validation error"],"whenToPreferThis":"Use this endpoint when you specifically need the native coin balance (ETH or POL) of any address — including EOAs, smart contracts, or multisigs — on Base, Ethereum, Arbitrum, Optimism, or Polygon. Prefer this over ERC-20 balance endpoints when the token in question is the chain's native gas token rather than an ERC-20 contract. It is the right choice when you need on-chain real-time data (not a cached or aggregated balance from an explorer) and need the exact wei value alongside the confirming block number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:43:34.211Z","isFirstParty":false,"canonicalSlug":"native-coin-balance-lookup-eth-pol-via-eth-getbalance-abffba6b"}