# Multi-Chain EVM Balance Reader (Native + ERC20, Up to 5 Chains)

> Multi-Chain EVM Balance Reader (Native + ERC20, Up to 5 Chains) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-01).

Fetches native coin and ERC20 token balances for an EVM address across up to 5 chains in a single call

## Facts

- Endpoint: POST https://twin.unykorn.org/evm-balance?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/multi-chain-evm-balance-reader-native-erc20-up-to-5-chains-2410fae5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P3cErsAGuhedFgB6yzO24

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-chain-evm-balance-reader-native-erc20-up-to-5-chains-2410fae5 -d '<json body>'
```

Example prompt: What are the native ETH and USDC balances for wallet 0x7d9a...156DB on Base, Arbitrum, and Polygon right now?

## When to prefer this

Choose this endpoint when you need balances across multiple EVM chains in a single low-latency call rather than making separate RPC requests per chain. It is ideal for portfolio dashboards, wallet audits, pre-transaction checks, and any scenario where you need native + ERC20 data together. Prefer it over single-chain alternatives when the user's address may hold assets on 2-5 different chains simultaneously. At $0.008 per call it is cost-effective compared to orchestrating multiple individual RPC calls.

## Known failure modes

- Invalid EVM address format returns validation error
- Unsupported chain name causes rejection — only ethereum, base, polygon, arbitrum, optimism are valid
- More than 5 chains or 10 tokens in request exceeds limits and is rejected
- RPC node unavailability for a specific chain returns that chain with available:false
- Payment failure or insufficient funds blocks the call before execution
- Malformed token contract address (not 0x + 40 hex chars) causes schema validation error

## How this service works

Multi-chain EVM balance read — native + ERC20, up to 5 chains in ONE call — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object containing per-chain balance data including native token amounts, ERC20 token balances with symbol and decimals, chain IDs, availability flags, an evidence hash for auditability, and a payment receipt with transaction hash and amount paid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chains": {
     "type": "array",
     "items": {
      "enum": [
       "ethereum",
       "base",
       "polygon",
       "arbitrum",
       "optimism"
      ],
      "type": "string"
     },
     "maxItems": 5
    },
    "tokens": {
     "type": "array",
     "items": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
     },
     "maxItems": 10
    },
    "address": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "evm-balance",
  "address": "0x7d9a…156DB",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.008,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "url": "https://mainnet.base.org",
    "name": "base:eth_getBalance"
   }
  ],
  "balances": {
   "base": {
    "native": "0.000009745904142039",
    "tokens": {
     "0x8335…2913": {
      "raw": "8000000",
      "symbol": "USDC",
      "balance": "8",
      "decimals": 6,
      "available": true
     }
    },
    "chain_id": 8453,
    "available": true,
    "native_symbol": "ETH"
   }
  },
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/multi-chain-evm-balance-reader-native-erc20-up-to-5-chains-2410fae5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)