# call402.com Base Wallet Lookup

> call402.com Base Wallet Lookup is a paid API for AI agents from call402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-20).

Looks up native ETH and token balances for a Base wallet address by reading directly from Base chain state via public RPC, covering 195 curated tokens plus transfer-discovered tokens within a configurable block window.

## Facts

- Endpoint: POST https://call402.com/api/wallet-lookup?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/call402-com-base-wallet-lookup-0762d73a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lxbU-0h-kefyvBP1geA8n

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 call402-com-base-wallet-lookup-0762d73a -d '<json body>'
```

Example prompt: What tokens and ETH does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base right now — scan the last 50000 blocks for any transfers?

## When to prefer this

Choose this endpoint when you need on-chain Base wallet balances read directly from chain state without relying on a centralized data API or indexer. It is ideal for agents operating in trust-minimized or DeFi contexts where self-hosted RPC reads are preferred over third-party enrichment APIs. It covers 195 curated tokens plus transfer-discovered tokens, so it works well for most common Base assets. Prefer alternatives if you need USD valuations, multi-chain support, or coverage of highly obscure tokens with no recent transfer history.

## Known failure modes

- Invalid or malformed wallet address (not 0x + 40 hex chars) returns an error
- Window parameter outside 1000–200000 range is rejected
- Tokens outside the curated 195-token list with no transfers in the discovery window are silently omitted (coverage gap)
- RPC node unavailability may cause lookup failures or stale data
- Very new tokens not yet in the curated list and with no transfer history in the window will not appear in results

## How this service works

Look up a Base wallet address: native ETH plus balances for a curated list of 195 tokens, read directly from Base chain state via public RPC with a self-hosted reader (no third-party data API). The response includes a coverage field: tokens outside the list with no transfers in the discovery window (default about 28 hours) are not reported. Balances only; no USD valuation.

## Output

Returns native ETH balance and balances for up to 195 curated ERC-20 tokens plus any additional tokens discovered via transfer events in the specified block window. Also includes a coverage field indicating which tokens fall outside the curated list and the discovery window. No USD valuations are provided — raw on-chain token amounts only.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "window": {
   "type": "integer",
   "description": "Optional discovery window in blocks, 1000-200000 (default 50000, about 28 hours)"
  },
  "address": {
   "type": "string",
   "description": "Base wallet address, required (0x + 40 hex chars)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "address",
   "block_number",
   "native",
   "tokens",
   "coverage",
   "elapsed_ms"
  ],
  "properties": {
   "native": {
    "type": "object",
    "required": [
     "symbol",
     "decimals",
     "balance_raw",
     "balance"
    ],
    "properties": {
     "symbol": {
      "type": "string",
      "const": "ETH"
     },
     "balance": {
      "type": "string"
     },
     "decimals": {
      "type": "integer",
      "const": 18
     },
     "balance_raw": {
      "type": "string"
     }
    }
   },
   "tokens": {
    "type": "array",
    "items": {
     "type": "object",
     "required": [
      "address",
      "symbol",
      "decimals",
      "balance_raw",
      "balance",
      "source"
     ],
     "properties": {
      "source": {
       "enum": [
        "list",
        "discovery"
       ],
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "address": {
       "type": "string"
      },
      "balance": {
       "type": "string"
      },
      "decimals": {
       "type": "integer"
      },
      "balance_raw": {
       "type": "string"
      }
     }
    }
   },
   "address": {
    "type": "string"
   },
   "coverage": {
    "type": "object",
    "required": [
     "token_list_size",
     "checked",
     "discovery_window_blocks",
     "discovery_from_block",
     "discovery_to_block",
     "discovery_watchlist_size",
     "discovery_contracts_scanned",
     "discovery_batches_failed",
     "discovered_off_list",
     "discovered_with_balance",
     "multicall3",
     "notes"
    ],
    "properties": {
     "notes": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "checked": {
      "type": "integer"
     },
     "multicall3": {
      "type": "string"
     },
     "token_list_size": {
      "type": "integer"
     },
     "discovery_to_block": {
      "type": "integer"
     },
     "discovered_off_list": {
      "type": "integer"
     },
     "discovery_from_block": {
      "type": "integer"
     },
     "discovered_with_balance": {
      "type": "integer"
     },
     "discovery_window_blocks": {
      "type": "integer"
     },
     "discovery_batches_failed": {
      "type": "integer"
     },
     "discovery_watchlist_size": {
      "type": "integer"
     },
     "discovery_contracts_scanned": {
      "type": "integer"
     }
    }
   },
   "elapsed_ms": {
    "type": "integer"
   },
   "block
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/call402-com-base-wallet-lookup-0762d73a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from call402.com](https://www.zero.xyz/host/call402.com/llms.txt)
