# EVM Native Token Balance Lookup > EVM Native Token Balance Lookup is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-20). Returns the native token balance (ETH, MATIC, etc.) for a given EVM wallet address on a specified chain, read live from a public node ## Facts - Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/evm/native-balance?utm_source=zero.xyz - Price: $0.001/call - Payment: x402 - Status: unknown - Last checked: 2026-10-20 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/evm-native-token-balance-lookup-961fd856 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QHnwdrB97tdQ4ZeRsFica Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability evm-native-token-balance-lookup-961fd856 ``` Example prompt: Check the current ETH balance on Base for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — read it live from the chain, not from a cache. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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" }, " … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-native-token-balance-lookup-961fd856/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev](https://www.zero.xyz/host/x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/llms.txt)