# Avasis ETH Multi-Balance Lookup

> Avasis ETH Multi-Balance Lookup is a paid API for AI agents from agents.avasis.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Returns ETH balance, USDC balance, and up to 10 ERC-20 token balances with USD prices for any Ethereum wallet or contract address in one call.

## Facts

- Endpoint: GET https://agents.avasis.ai/v1/eth/multi-balance?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/avasis-eth-multi-balance-lookup-d89faa33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CMMFAAFY7mtdIXUuKmdFg

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 avasis-eth-multi-balance-lookup-d89faa33
```

Example prompt: What's the ETH, USDC, WETH, and WBTC balance of 0xf977814e90da44bfa03b6295a0616a897441acec on Ethereum, and what's the total USD value?

## When to prefer this

Choose this endpoint when you need a complete multi-asset Ethereum portfolio snapshot — ETH plus multiple ERC-20s with live USD prices — in a single x402 micropayment call with no API key or account setup. It is ideal for agents that need to assess wallet holdings, check gas affordability, or audit contract treasuries on Ethereum mainnet. Prefer it over individual balance checks when you need aggregated USD totals and gas estimates simultaneously at $0.02 per call.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain specified (only Ethereum/chain 1 on this route)
- More than 10 token addresses requested exceeds the limit
- Unknown token symbol not in the known-symbols list may return null price
- RPC timeout or node unavailability may delay response
- Token with no liquidity may return unpriced entry in totals.unpriced array

## How this service works

Wallet multi-balance on Ethereum (chain 1, $0.02): address -> ETH + USDC + up to 10 ERC-20s (addresses or symbols: USDC, USDT, DAI, WETH, WBTC) in ONE batched read: raw + units, USD per asset and total (Chainlink, pegs, Dexscreener), tx_count, is_contract, empty flag, gas affordability (ETH transfer cost at 2x base fee, can_pay_eth_transfer). Phrases: wallet balance, multi balance, usdc balance, eth balance. GET or POST JSON. Per-token fail-soft; RPC down 502, never charged.

## Output

Returns a JSON object with ETH balance (amount, wei, USD value, Chainlink price), USDC balance, an array of requested ERC-20 token balances (amount, raw, decimals, USD price, price source), aggregated totals in USD, gas cost estimates and how many ETH transfers the wallet can afford, transaction count, block number, contract/EOA flag, and a human-readable headline string summarizing the portfolio.

## 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": {
       "type": "string",
       "description": "optional; must be ethereum / 1 on this route"
      },
      "tokens": {
       "type": "string",
       "description": "optional comma-separated ERC-20 addresses or known symbols (USDC, USDT, DAI, WETH, WBTC), up to 10; USDC is always included"
      },
      "address": {
       "type": "string",
       "description": "the wallet or contract to read (0x + 40 hex)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "chain",
      "address",
      "eth",
      "usdc",
      "tokens",
      "totals",
      "gas",
      "headline"
     ],
     "properties": {
      "eth": {
       "type": "object"
      },
      "gas": {
       "type": "object"
      },
      "kind": {
       "type": "string"
      },
      "rail": {
       "type": "string"
      },
      "usdc": {
       "type": "object"
      },
      "chain": {
       "type": "string"
      },
      "empty": {
       "type": "boolean"
      },
      "tokens": {
       "type": "array"
      },
      "totals": {
       "type": "object"
      },
      "address": {
       "type": "string"
      },
      "chain_id": {
       "type": "integer"
      },
      "headline": {
       "type": "string"
      },
      "tx_count": {
       "type": [
        "integer",
        "null"
       ]
      },
      "is_contract": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "block_number": {
       "type": "integer"
      },
      "also_available": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eth": {
   "usd": 94.43,
   "wei": "42100000000000000",
   "price": 2242.9,
   "amount": "0.0421",
   "price_source": "chainlink ETH/USD (latestRoundData)"
  },
  "gas": {
   "note": "21000 gas at 2x the current base fee + 0.001 gwei tip; excludes the Base L1 data fee (~$0.0003-0.001 per tx); contract calls cost more: /v1/evm/gas-ops prices them",
   "base_fee_gwei": 0.005,
   "can_pay_eth_transfer": true,
   "eth_transfer_cost_eth": "0.000000231",
   "eth_transfer_cost_usd": 0.0005181,
   "eth_transfer_cost_wei": "231000000000",
   "eth_transfers_affordable": 182251
  },
  "kind": "multi-balance",
  "rail": "evm-rails-1",
  "usdc": {
   "usd": 15115.05,
   "error": null,
   "amount": "15115.05",
   "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"
  },
  "chain": "ethereum",
  "empty": false,
  "reads": {
   "rpc": "fixture",
   "calls": 8,
   "elapsed_ms": 0
  },
  "tokens": [
   {
    "raw": "15115050000",
    "usd": 15115.05,
    "error": null,
    "known": "USDC (Circle)",
    "price": 1,
    "amount": "15115.05",
    "symbol": "USDC",
    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "decimals": 6,
    "price_source": "stablecoin peg (known issuer)"
   },
   {
    "raw": "250000000000000000",
    "usd": 560.73,
    "error": null,
    "known": "WETH (canonical)",
    "price": 2242.9,
    "amount": "0.25",
    "symbol": "WETH",
    "address": "0x4200000000000000000000000000000000000006",
    "decimals": 18,
    "price_source": "chainlink ETH/USD (latestRoundData)"
   },
   {
    "raw": "120000",
    "usd": 131.85,
    "error": null,
    "known": "cbBTC (Coinbase)",
    "price": 109876.5,
    "amount": "0.0012",
    "symbol": "cbBTC",
    "address": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
    "decimals": 8,
    "price_source": "dexscreener aerodrome (liquidity $12,345,678)"
   }
  ],
  "totals": {
   "usd": 15902.06,
   "note": "ETH + priced tokens at current prices",
   "complete": true,
   "unpriced": []
  },
  "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
  "chain_id": 1,
  "headline": "0xf977…acec on Base: 0.0421 ETH ($94.43), 15,115.05 USDC, 0.25 WETH, 0.0012 cbBTC; total $15,902.06; gas for 182251 ETH transfers",
  "tx_count": 499417,
  "is_contract": false,
  "block_number": 53354727,
  "block_timestamp": 1793498801
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/avasis-eth-multi-balance-lookup-d89faa33/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.avasis.ai](https://www.zero.xyz/host/agents.avasis.ai/llms.txt)