# ManyLives Onchain ERC-20 Balance

> ManyLives Onchain ERC-20 Balance is a paid API for AI agents from api.manylives.me, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

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

## Facts

- Endpoint: GET https://api.manylives.me/paid/chain/erc20-balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/manylives-onchain-erc-20-balance-c0a39d8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qZ-VOb9zPoVmlQlKsqOlZ

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 manylives-onchain-erc-20-balance-c0a39d8b
```

Example prompt: What's the USDC balance of wallet 0x4200000000000000000000000000000000000006 on Base right now?

## When to prefer this

Use this endpoint when an AI agent needs to check an ERC-20 token balance on the Base L2 network specifically, especially in a pay-per-call context without needing an account or API key. Ideal for trading agents that need on-chain balance verification before executing trades, or for monitoring wallet holdings programmatically. Prefer over general blockchain APIs when you need Base-native data with x402 micropayment compatibility.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Invalid token contract address returns an error or zero balance
- Token contract does not exist on Base network — may return zero or error
- Payment not fulfilled — endpoint returns HTTP 402 requiring USDC micropayment
- Network congestion on Base may cause slow or failed RPC calls

## How this service works

Pay-per-call tools for people building AI agents: live web search and page contents, point-in-time crypto market data and news for backtests (no lookahead), verifiable track records of 1,000 crypto strategies locked on the Base network, company profiles, quick AI and batch prices. Ask us to turn a public website into a JSON endpoint. Pay per call, no account, free trial.

## Output

Returns a JSON object with the wallet address, token contract address, token symbol, number of decimals, the raw integer balance (as a string), and the human-readable balance string adjusted for decimals (e.g. '1.2345').

## 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": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "wallet"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "0x... ERC-20 on the Base network (optional, default: the main US-dollar stablecoin)"
      },
      "wallet": {
       "type": "string",
       "examples": [
        "0x4200000000000000000000000000000000000006"
       ],
       "description": "0x... (required)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "properties": {
      "raw": {
       "type": "string"
      },
      "token": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "wallet": {
       "type": "string"
      },
      "balance": {
       "type": "string"
      },
      "decimals": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "1234500",
  "token": "0x...",
  "symbol": "TKN",
  "wallet": "0x...",
  "balance": "1.2345",
  "decimals": 6
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/manylives-onchain-erc-20-balance-c0a39d8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.manylives.me](https://www.zero.xyz/host/api.manylives.me/llms.txt)