{"uid":"cap_QHnwdrB97tdQ4ZeRsFica","slug":"evm-native-token-balance-lookup-961fd856","name":"EVM Native Token Balance Lookup","description":"An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over the live x402 service market, every indexed service scored by real 30-day calls and paying-wallet bounds, with a receipt naming the snapshot hash and scoring revision. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 and per-service MPP listings are not covered.","url":"https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/evm/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","HEAD"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["ethereum","base","arbitrum","polygon","optimism"],"type":"string","default":"base","description":"Chain; default base"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x address (40 hex)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","chainId","block","as_of","errors","note","address","symbol","raw","amount"],"properties":{"raw":{"type":"string","description":"Balance in wei"},"note":{"type":"string","description":"Fixed text: read from a public node, no USD prices"},"as_of":{"type":"string","description":"ISO 8601 UTC time of the reply"},"block":{"type":["integer","null"],"description":"Latest block at the node when it answered"},"chain":{"enum":["ethereum","base","arbitrum","polygon","optimism"],"type":"string","description":"Chain key"},"amount":{"type":"string","description":"Balance in whole coins"},"errors":{"type":"array","items":{"type":"string"},"description":"Calls or fields the node did not return"},"source":{"type":["string","null"],"description":"Public node host that answered"},"symbol":{"type":"string"},"address":{"type":"string"},"chainId":{"type":"integer","description":"EVM chain id"},"decimals":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"raw":"120000000000000000","note":"Read directly from a public node at the block shown; nothing is cached, estimated or priced in USD. A field the node did not return is null and named in errors.","as_of":"2026-10-19T12:00:00.000Z","block":52207800,"chain":"base","amount":"0.12","errors":[],"source":"base.drpc.org","symbol":"ETH","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","chainId":8453,"decimals":18}},"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_GxbhyvDFvtcrl0Y7wc8P3","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.) for a given EVM wallet address on a specified chain, read live from a public node","exampleAgentPrompt":"Check the current ETH balance on Base for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — read it live from the chain, not from a cache.","exampleUseCases":[{"title":"Pre-flight agent wallet funding check","prompt":"Before my agent submits a transaction on Base, check whether wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 has enough ETH — look up its live native balance right now."},{"title":"Multi-chain portfolio snapshot","prompt":"What is the native token balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Arbitrum? Give me the amount in whole ETH and tell me which block the reading came from."},{"title":"Verify smart contract deployer balance","prompt":"Check how much ETH the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently holds on Ethereum mainnet — I need to know if it can cover gas for a deployment."}],"resultDescription":"Returns a JSON object with the native token balance in both raw wei and whole-coin units, the token symbol, chain key and chain ID, the block number at which the node answered, an ISO 8601 timestamp, the public node host that responded, and an errors array listing any fields the node did not return. No USD pricing is included.","failureModes":["Invalid address format (not matching ^0x[0-9a-fA-F]{40}$) causes a validation error","Unsupported chain value outside the allowed enum returns an error","Public node unavailable or rate-limited causes null fields and entries in the errors array","Network congestion may cause stale or delayed block numbers","Missing required address query parameter causes a 4xx error"],"whenToPreferThis":"Use this endpoint when you need a live, uncached native token balance for an EVM address on Base, Ethereum, Arbitrum, Polygon, or Optimism and do not need USD pricing. Ideal for agent pre-flight checks, wallet funding verification, or on-chain portfolio reads where freshness matters more than price context. Not suitable if you need ERC-20 token balances, historical balances, or USD-denominated values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:32:46.257Z","isFirstParty":false,"canonicalSlug":"evm-native-token-balance-lookup-961fd856"}