# P0 Agent Economy Index — Wallet Balance Lookup

> P0 Agent Economy Index — Wallet 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.002/call, status unknown (last checked 2026-10-12).

Fetches native token and ERC-20 token balances for a given Ethereum address or ENS name across multiple EVM chains in real time.

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/wallet/balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/p0-agent-economy-index-wallet-balance-lookup-b270c10a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j_qiA5uEA3CjNFhp3Fuz7

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 p0-agent-economy-index-wallet-balance-lookup-b270c10a
```

Example prompt: What are the ETH and USDC balances for vitalik.eth across Base, Ethereum, and Arbitrum right now?

## When to prefer this

Use this endpoint when you need real-time, multi-chain EVM wallet balances (native + ERC-20) for a specific address or ENS name without requiring USD price conversion. It is distinct from price oracles or DEX APIs — it reads directly from public blockchain nodes at the latest block, making it ideal for checking whether an agent wallet has sufficient funds before executing a payment, or for auditing a wallet's on-chain holdings across Base, Ethereum, Arbitrum, and Polygon in a single call.

## Known failure modes

- Invalid or non-existent Ethereum address returns an error
- ENS name that cannot be resolved returns an error
- Specified chain times out and appears in the errors array rather than balances
- Unknown chain name in the chains query parameter causes a validation error
- Rate limiting or upstream node unavailability may cause partial chain failures
- Malformed address format (e.g. mixed case, missing 0x prefix) may fail validation

## 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 resolved wallet address, ENS name details (if applicable), per-chain breakdowns including native token (symbol, raw amount, human-readable amount, decimals) and ERC-20 token balances (symbol, contract, raw and formatted amounts), the block number used for each chain, the data source node, and any chains that returned errors instead of balances. No USD prices are 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": {
      "chains": {
       "type": "string",
       "description": "comma list of ethereum, base, arbitrum, polygon (default: all EVM chains for a 0x address)"
      },
      "address": {
       "type": "string",
       "description": "0x address or ENS name (lowercase a-z, 0-9, hyphen)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "kind",
      "asOf",
      "chains",
      "errors",
      "note"
     ],
     "properties": {
      "ens": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "resolver": {
         "type": "string"
        }
       }
      },
      "asOf": {
       "type": "string"
      },
      "kind": {
       "type": "string"
      },
      "note": {
       "type": "string"
      },
      "input": {
       "type": "string"
      },
      "chains": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "chain",
         "native",
         "tokens"
        ],
        "properties": {
         "block": {
          "type": [
           "integer",
           "null"
          ]
         },
         "chain": {
          "type": "string"
         },
         "native": {
          "type": "object",
          "required": [
           "symbol",
           "decimals",
           "raw",
           "amount"
          ],
          "properties": {
           "raw": {
            "type": "string"
           },
           "amount": {
            "type": "string"
           },
           "symbol": {
            "type": "string"
           },
           "contract": {
            "type": "string"
           },
           "decimals": {
            "type": "integer"
           }
          }
         },
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ens": {
   "name": "vitalik.eth",
   "resolver": "0x231b0ee14048e9dccd1d247744d114a4eb5e8e63"
  },
  "asOf": "2026-10-05T12:00:00.000Z",
  "kind": "ens",
  "note": "Balances read directly from public blockchain nodes at the block shown for each chain. No USD prices. A chain that did not answer is listed in errors, never reported as zero.",
  "input": "vitalik.eth",
  "chains": [
   {
    "block": 52207539,
    "chain": "base",
    "native": {
     "raw": "120000000000000000",
     "amount": "0.12",
     "symbol": "ETH",
     "decimals": 18
    },
    "source": "base.drpc.org",
    "tokens": [
     {
      "raw": "25000000",
      "amount": "25",
      "symbol": "USDC",
      "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "decimals": 6
     }
    ],
    "chainId": 8453,
    "explorer": "https://basescan.org/address/0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "tokenErrors": []
   }
  ],
  "errors": [
   {
    "chain": "polygon",
    "error": "timeout"
   }
  ],
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/p0-agent-economy-index-wallet-balance-lookup-b270c10a/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)