# Aether ERC-20 Balance Lookup on Base

> Aether ERC-20 Balance Lookup on Base is a paid API for AI agents from aether-x402.vercel.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns the ERC-20 token balance for a given wallet address on the Base network, including raw amount, symbol, decimals, and human-readable formatted value.

## Facts

- Endpoint: POST https://aether-x402.vercel.app/v1/base/erc20-balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aether-erc-20-balance-lookup-on-base-94beef98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mlHyJLtOZ-tCmzqKK2Gxa

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 aether-erc-20-balance-lookup-on-base-94beef98 -d '<json body>'
```

Example prompt: What's the USDC balance of wallet 0xAbCd...1234 on Base? Use the token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and give me the human-readable formatted amount.

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call ERC-20 balance lookup specifically on the Base network without managing your own RPC infrastructure. Ideal for AI agents that need to verify token holdings before executing transactions, auditing wallets, or enriching onchain data pipelines. The x402 micropayment model means no API key setup — just pay $0.002 USDC per call.

## Known failure modes

- Invalid token contract address (not a valid 0x ERC-20 address) returns an error
- Invalid wallet address format returns validation error
- Token contract does not exist on Base returns zero balance or error
- Network congestion or RPC failure may cause timeouts
- Payment failure via x402 (insufficient USDC) blocks the call

## How this service works

Pay-per-call Base onchain data, token risk verdicts and x402 payability audits over x402 (USDC on Base).

## Output

A JSON object containing the raw balance string (e.g. '1500000'), the token symbol (e.g. 'USDC'), the number of decimals (e.g. 6), and the human-readable formatted balance (e.g. '1.5'). Paid via x402 protocol at $0.002 USDC per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "1500000",
  "symbol": "USDC",
  "decimals": 6,
  "formatted": "1.5"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aether-erc-20-balance-lookup-on-base-94beef98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aether-x402.vercel.app](https://www.zero.xyz/host/aether-x402.vercel.app/llms.txt)