# ERC-20 Token Balance Lookup (Multi-Chain EVM)

> ERC-20 Token Balance Lookup (Multi-Chain EVM) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-20).

Returns the ERC-20 token balance for a given wallet address on a specified EVM chain, including token name, symbol, decimals, and raw/formatted balance.

## Facts

- Endpoint: POST https://api.vextorium.com/evm-saldo-token-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-balance-lookup-multi-chain-evm-97507d25
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qKOeDAVoIBU1iZAotGdWq

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 erc-20-token-balance-lookup-multi-chain-evm-97507d25 -d '<json body>'
```

Example prompt: What's the USDC balance (token address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf on Base — give me the formatted balance plus the symbol and decimals?

## When to prefer this

Use this endpoint when you need to query an ERC-20 token balance for a specific wallet on any major EVM-compatible chain (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain) and want the result enriched with token metadata (name, symbol, decimals) in a single call. Prefer this over raw RPC calls when you need a clean JSON response without managing blockchain node connections. Best for DeFi automation, portfolio tracking, pre-transaction checks, and airdrop verification.

## Known failure modes

- Invalid wallet address format returns null fields or an error
- Token contract address not found on the specified chain returns null balance
- Unsupported chain identifier causes validation failure
- Network timeout or RPC unavailability results in an error response
- Wallet with zero token holdings returns saldo of 0 and saldo_bruto of '0'

## How this service works

Balance of one ERC-20 token in a wallet with symbol and decimals. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.

## Output

Returns a JSON object with the chain name, wallet address, token contract address, token name, symbol, number of decimals, human-readable balance (saldo), and raw integer balance string (saldo_bruto). All fields may be null if the token or wallet is not found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "red": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bnb",
    "avalanche",
    "gnosis",
    "linea",
    "scroll",
    "sonic",
    "unichain"
   ],
   "type": "string",
   "description": "Chain (default base)"
  },
  "token": {
   "type": "string"
  },
  "direccion": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "red": "base",
  "saldo": 1.541325,
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "nombre": "USD Coin",
  "wallet": "0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf",
  "simbolo": "USDC",
  "decimales": 6,
  "saldo_bruto": "1541325"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-balance-lookup-multi-chain-evm-97507d25/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)