# Agent Tools – Multi-Chain Wallet Balance

> Agent Tools – Multi-Chain Wallet Balance is a paid API for AI agents from agents.crowdspark.me, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Fetches native coin balance (with USD value via Chainlink) and up to 10 ERC20 token balances for a wallet address on Base, Ethereum, Optimism, Arbitrum, or Polygon.

## Facts

- Endpoint: GET https://agents.crowdspark.me/v1/chain/balance?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/agent-tools-multi-chain-wallet-balance-00d8d889
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e4JfHSITNdfp20vWSndQG

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 agent-tools-multi-chain-wallet-balance-00d8d889
```

Example prompt: Can you check the ETH balance and USDC balance (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0x0dEA0030A17BF886543a757c55924710258c2eec on Base, and tell me the USD value?

## When to prefer this

Use this endpoint when an AI agent needs to read on-chain wallet balances live from public RPC nodes across Base, Ethereum, Optimism, Arbitrum, or Polygon — especially before executing swaps, payments, or funding decisions. Prefer this over block-explorer APIs when you need USD-denominated native balance (via Chainlink) and multi-token ERC20 balances in a single call without an API key.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain name returns validation error
- ERC20 token contract address not found or invalid returns null/missing token in array
- RPC node temporarily unavailable causes request failure
- Requesting more than 10 ERC20 token addresses truncates or errors
- Chainlink price feed unavailable may cause missing USD value

## How this service works

Pay-per-call utilities for AI agents over x402, USDC on Base.

## Output

Returns a JSON object with the chain name, the wallet address, the native coin symbol, balance string, and USD value (via Chainlink price feed), plus an array of up to 10 ERC20 token objects each containing the token contract address, symbol, and balance string.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "optimism",
        "arbitrum",
        "polygon"
       ],
       "type": "string",
       "description": "Default base"
      },
      "tokens": {
       "type": "string",
       "description": "Optional comma list of up to 10 ERC20 addresses"
      },
      "address": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "native": {
   "usd": 2.78,
   "symbol": "ETH",
   "balance": "0.0012"
  },
  "tokens": [
   {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "balance": "1.5"
   }
  ],
  "address": "0x0dEA0030A17BF886543a757c55924710258c2eec"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-tools-multi-chain-wallet-balance-00d8d889/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.crowdspark.me](https://www.zero.xyz/host/agents.crowdspark.me/llms.txt)