# Multi-Address ETH Balance Batch Lookup

> Multi-Address ETH Balance Batch Lookup is a paid API for AI agents from www.x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns native ETH balances for up to 20 Ethereum wallet addresses in a single call via Etherscan V2

## Facts

- Endpoint: GET https://www.x402financialdata.com/multi-balance
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/multi-address-eth-balance-batch-lookup-e8e567a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tm8Crrpdh1tFcp7c_fIzJ

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 multi-address-eth-balance-batch-lookup-e8e567a6
```

Example prompt: Can you fetch the current native ETH balances for all of these wallets at once: 0xABC...1, 0xDEF...2, 0x123...3, and 0x456...4 — I want to see them all in one shot instead of looking each one up separately.

## When to prefer this

Use this endpoint when you need ETH balances for 2–20 wallets simultaneously and want to avoid making N separate calls. It is ideal for portfolio dashboards, airdrop screens, whale tracking, and any scenario where you have a known list of addresses. If you only need one address, a single-address balance endpoint may suffice, but this endpoint still works for one. Prefer this over iterating single-balance calls to reduce latency and cost. Note it returns only native ETH, not ERC-20 token balances.

## Known failure modes

- More than 20 addresses submitted — API will reject or truncate the list
- Invalid or malformed Ethereum address in the list — may return an error or zero balance for that entry
- Non-ETH chain requested (only 'eth' is currently supported) — unsupported chain will be rejected
- Network or upstream Etherscan outage — may return 5xx or timeout
- Empty address list — required parameter missing causes validation error

## How this service works

Native ETH balance for up to 20 wallet addresses in one call, from Etherscan's V2 API -- a portfolio-style batch lookup instead of N separate /wallet-balance calls. Not address-scoped in the path; pass addresses as a comma-separated query param. $0.01/call.

## Output

Returns an array of objects, each containing the queried wallet address and its current native ETH balance on the Ethereum mainnet, sourced from Etherscan V2. Up to 20 addresses are resolved in a single response.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "addresses"
     ],
     "properties": {
      "chain": {
       "enum": [
        "eth"
       ],
       "type": "string",
       "description": "Which chain to query. Only 'eth' is supported right now."
      },
      "addresses": {
       "type": "string",
       "description": "Comma-separated EVM addresses, up to 20."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/multi-address-eth-balance-batch-lookup-e8e567a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402financialdata.com](https://www.zero.xyz/host/www.x402financialdata.com/llms.txt)