# wafermap.xyz Wallet Balances

> wafermap.xyz Wallet Balances is a paid API for AI agents from wafermap.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Returns ETH and stablecoin balances for any wallet address on Robinhood Chain or Base, plus balances for additional specified token contracts.

## Facts

- Endpoint: POST https://wafermap.xyz/v1/wallet-balances?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wafermap-xyz-wallet-balances-604394eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bbpN8VNCMFpLs4zTQzCly

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 wafermap-xyz-wallet-balances-604394eb -d '<json body>'
```

Example prompt: What's the ETH balance and any USDC or USDT holdings for wallet 0xAbC1234567890AbcD1234567890aBcD12345678 on Base?

## When to prefer this

Use this endpoint when you need a fast, on-demand lookup of ETH, stablecoin, and arbitrary ERC-20 token balances for a specific wallet address on Robinhood Chain or Base. It is particularly well-suited for agentic workflows that need to check wallet liquidity before executing transactions, audit user portfolios, or display holdings in real time. Prefer it over general blockchain explorers when you need a structured, programmatic response for multiple tokens in a single call.

## Known failure modes

- Invalid wallet address format (not matching 0x + 40 hex chars) returns a validation error
- Unsupported network value outside 'robinhood' or 'base' enum returns an error
- Token address list exceeds 10 entries may be rejected or truncated
- Undeployed or non-ERC20 token contract addresses may return zero or error
- Network RPC downtime may cause timeouts or empty responses
- Payment failure (x402) if USDC balance is insufficient to cover the $0.00138 fee

## How this service works

Wallet Balances — ETH and stablecoin balances for any address, plus any tokens you list.

## Output

Returns the ETH balance and stablecoin balances (e.g. USDC, USDT) held by the specified wallet address on the chosen network, along with balances for any additional token contract addresses provided. Balances are returned per token with amounts readable for downstream logic or display.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "string",
   "minLength": 1,
   "description": "Extra token addresses, comma-separated (up to 10)."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet address (0x…)."
  },
  "network": {
   "enum": [
    "robinhood",
    "base"
   ],
   "type": "string",
   "description": "robinhood (default) or base."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wafermap-xyz-wallet-balances-604394eb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wafermap.xyz](https://www.zero.xyz/host/wafermap.xyz/llms.txt)