{"uid":"cap_Vq3so_Lds8Ee25DmJ6O7g","slug":"evm-chain-native-balance-lookup-21a42d42","name":"EVM Chain Native Balance Lookup","description":"Company intelligence, KYB, sanctions screening and monitoring for AI agents. Pay per call with x402 and USDC on Base. No API keys. Explore free samples.","url":"https://api.axiomworks.co.uk/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":{"block":{"type":"string","description":"Block number or tag (default latest)"},"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"wallet":{"type":"string","description":"Alias for address (owner wallet)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"block":{"type":"string"},"symbol":{"type":"string"},"balance":{"type":"string"},"balance_wei":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"block":26349613,"chain":"ethereum","source":"eth_getBalance","symbol":"ETH","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","balance":"5.780441042197210512","chain_id":1,"balance_wei":"5780441042197210512"}},"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":"down","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_-R6__Q7jGVsFifJrD8NzQ","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 native token balance (ETH, MATIC, etc.) of any EVM wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon at a given block.","exampleAgentPrompt":"What's the current ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet?","exampleUseCases":[{"title":"Pre-transaction fund verification","prompt":"Before I send that payment, check if the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 has at least 1 ETH on Base right now."},{"title":"Historical balance snapshot","prompt":"What was the ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum at block 19000000?"},{"title":"Cross-chain portfolio check","prompt":"Can you tell me how much MATIC the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 is holding on Polygon right now?"}],"resultDescription":"A JSON object containing the native token balance as a human-readable decimal string, the raw balance in wei, the block number at which the balance was read, the chain name and chain ID, the wallet address queried, and the token symbol (e.g. ETH, MATIC).","failureModes":["Invalid address format (not a valid 0x hex address) returns an error","Unsupported chain name returns a validation error","Requested block number does not exist or is ahead of chain tip returns an error","Rate limiting or RPC node unavailability may cause transient failures","Network connectivity issues to underlying EVM node"],"whenToPreferThis":"Use this endpoint when you need the native token balance (ETH, MATIC, ARB, etc.) of a wallet on a supported EVM chain. Prefer this over ERC20 token balance endpoints when you specifically need the gas token or native currency balance. It supports historical block queries making it suitable for point-in-time snapshots. It covers five major EVM chains in a single API, eliminating the need to manage separate RPC connections per chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T07:28:09.337Z","isFirstParty":false,"canonicalSlug":"evm-chain-native-balance-lookup-21a42d42"}