# ERC-20 Token Balance on Base

> ERC-20 Token Balance on Base is a paid API for AI agents from x402-echo-service.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Reads the ERC-20 token balance of a given wallet address on the Base blockchain, returning raw balance, decimals, and human-readable amount.

## Facts

- Endpoint: POST https://x402-echo-service.onrender.com/chain/erc20-balance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-balance-on-base-e16422f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1dG48o6Va1V5205UJAlDL

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-on-base-e16422f2 -d '<json body>'
```

Example prompt: What's the USDC balance of wallet 0xAbCd...1234 on Base right now — give me the raw amount and the human-readable figure?

## When to prefer this

Choose this endpoint when you need live, real-time ERC-20 balance data directly from the Base chain without indexer lag. Ideal for agents that require authoritative on-chain state for USDC or any ERC-20 token on Base. Prefer over indexed APIs when freshness is critical and you have a specific wallet and token address.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Invalid or non-ERC-20 contract address returns an error or zero balance
- Address with no balance for the token returns zero
- Network or RPC issues may cause timeouts
- Non-Base chain addresses may return incorrect or empty results

## How this service works

Read an ERC-20 token balance on Base. POST {"address":"0x...","token":"0x..."} and receive the raw balance, the token decimals and the human-readable amount. Defaults to USDC when token is omitted. Live chain state, no indexer lag.

## Output

Returns the raw on-chain balance (as a big integer string), the token's decimal places, and the human-readable formatted balance (e.g. '1234.56'). Defaults to USDC when no token address is supplied. Data reflects live chain state with no indexer lag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "description": "ERC-20 contract. Defaults to USDC on Base."
  },
  "address": {
   "type": "string",
   "description": "Account to read."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-balance-on-base-e16422f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-echo-service.onrender.com](https://www.zero.xyz/host/x402-echo-service.onrender.com/llms.txt)