# ChainScope Batch Wallet Balance

> ChainScope Batch Wallet Balance is a paid API for AI agents from chainsscope.duckdns.org, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches native token balances and USD values for multiple wallet addresses across Ethereum, Base, Bitcoin, and Solana in a single batch request

## Facts

- Endpoint: POST https://chainsscope.duckdns.org/tools/wallet-balance/batch
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainscope-batch-wallet-balance-2d67650d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NHyu_kT_s9goflWaIsY6s

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 chainscope-batch-wallet-balance-2d67650d -d '<json body>'
```

Example prompt: Can you check the current native token balances and USD values for these three wallets all at once — 0x1f5f8474fA0dc1Fde79187abd68Ef8Ea15ADAe34 on Ethereum, yEx9WBP1NnzoTpDmi67F536bso3YNcQPBRhWRoswTBS on Solana, and 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf on Bitcoin?

## When to prefer this

Choose this endpoint when you need to look up native token balances for multiple wallet addresses across different blockchains (Ethereum, Base, Bitcoin, Solana) in a single API call, rather than making separate per-chain requests. It is ideal for portfolio monitoring, airdrop validation, treasury checks, or any scenario where cross-chain balance aggregation in one round-trip saves integration complexity. Prefer this over single-address endpoints when you have 2+ addresses to check.

## Known failure modes

- Invalid or malformed wallet address returns an error field populated for that specific address while other results succeed
- Unsupported chain identifier causes an error for that entry
- Network timeouts or RPC failures for a specific chain may return partial results with error set
- Entire request fails if the request body is malformed or missing required fields
- Rate limiting or payment failure results in HTTP 402 or 429 with no results returned

## How this service works

Check up to 10 wallets in one call -- mix chains freely (e.g. an Ethereum wallet and a Solana wallet in the same request). Cheaper per item than calling wallet-balance that many times separately. A bad address in the batch doesn't fail the whole call -- that item just comes back with an error, the rest still succeed.

## Output

Returns an array of results, one per queried address, each containing the chain name, the wallet address, the native token symbol (e.g. ETH, SOL, BTC), the native token balance as a string, the USD value of that balance, and a nullable error field indicating any per-address lookup failures.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "wallets": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "address",
     "chain"
    ],
    "properties": {
     "chain": {
      "enum": [
       "ethereum",
       "base",
       "bitcoin",
       "solana",
       "arbitrum",
       "optimism",
       "polygon"
      ],
      "type": "string"
     },
     "address": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "chain": "ethereum",
    "error": null,
    "address": "0x1f5f8474fA0dc1Fde79187abd68Ef8Ea15ADAe34",
    "native_symbol": "ETH",
    "native_balance": "1.5",
    "native_value_usd": 3000
   },
   {
    "chain": "solana",
    "error": null,
    "address": "yEx9WBP1NnzoTpDmi67F536bso3YNcQPBRhWRoswTBS",
    "native_symbol": "SOL",
    "native_balance": "10",
    "native_value_usd": 1000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainscope-batch-wallet-balance-2d67650d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainsscope.duckdns.org](https://www.zero.xyz/host/chainsscope.duckdns.org/llms.txt)