# agent402.tools Wallet Balance Lookup

> agent402.tools Wallet Balance Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns native coin (ETH/MATIC) and all ERC-20 token balances for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism

## Facts

- Endpoint: POST https://agent402.tools/api/wallet-balance
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-wallet-balance-lookup-1c55cda3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1uohQfrE6DnrpkgGPbzHU

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 agent402-tools-wallet-balance-lookup-1c55cda3 -d '<json body>'
```

Example prompt: What ETH and ERC-20 tokens does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base — give me every token with its symbol, contract, and balance?

## When to prefer this

Use this endpoint when you need a complete, multi-token snapshot of a wallet's holdings on a specific EVM chain — especially when you need human-readable decimal balances across both native coin and ERC-20s without having to handle token decimals yourself. Ideal for portfolio analysis, DeFi position checks, or any agent workflow that needs to know 'what does this wallet have?' on Ethereum, Base, Polygon, Arbitrum, or Optimism.

## Known failure modes

- Invalid or malformed wallet address (not 0x-prefixed or wrong length) returns error
- Unsupported network name returns error or defaults to Base
- Wallet with no token holdings returns empty token list
- Network RPC unavailability causes timeout or partial result
- Payment failure (x402) prevents the call from completing

## How this service works

Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism. Returns clean decimal balances (already scaled by token decimals) plus symbol and contract - ready to display in a UI or feed into a portfolio tool.

## Output

A list of all token holdings for the specified wallet: native coin balance (e.g. ETH or MATIC, already decimal-scaled), plus each ERC-20 with its symbol, contract address, and human-readable balance. No raw wei values — everything is pre-scaled for immediate use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "0x-prefixed 40-char hex wallet address."
  },
  "network": {
   "type": "string",
   "description": "ethereum / base / polygon / arbitrum / optimism (default base)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "native": {
   "raw": "1234000000000000",
   "symbol": "ETH",
   "balance": "0.001234"
  },
  "tokens": [
   {
    "raw": "100000000",
    "symbol": "USDC",
    "balance": "100",
    "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "decimals": 6
   }
  ],
  "address": "0xabf4fabd7c416fb67202e5f9002389fc75e2a9d0",
  "network": "base"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-wallet-balance-lookup-1c55cda3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)