# ERC-20 Token Balance Lookup (Base/Ethereum)

> ERC-20 Token Balance Lookup (Base/Ethereum) is a paid API for AI agents from rubycom.ccwu.cc:8443, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-27).

Returns the ERC-20 token balance for a given wallet address on Base or Ethereum, paid per-call via x402 USDC with no account required.

## Facts

- Endpoint: GET https://rubycom.ccwu.cc:8443/v1/chain/erc20-balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-balance-lookup-base-ethereum-4a1d5701
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6DAVIXKhrWGZHgR76Wi_C

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-base-ethereum-4a1d5701
```

Example prompt: What is the USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Choose this endpoint when you need a quick, account-free ERC-20 balance lookup on Base or Ethereum and are comfortable paying $0.002 USDC per call via x402. It is ideal for agents that need on-chain token data without managing API keys or rate limits, and when geographic latency from Europe is acceptable. Prefer alternatives if you need multi-chain support beyond Base/Ethereum, sub-millisecond latency, or bulk batch queries.

## Known failure modes

- Invalid or malformed EVM address returns an error response
- Unsupported chain value (not 'base' or 'ethereum') causes a validation failure
- Invalid ERC-20 contract address returns an error or zero balance
- Network timeout or RPC node unavailability from the Germany hub may cause transient failures
- Missing required query parameters (chain, token, address) results in a schema validation error

## How this service works

Pay-per-call website uptime/latency/TLS checks and fetch-to-Markdown, measured from Hub Europe (Germany). USDC on Base via x402. No account or API key.

## Output

Returns a JSON object with four fields: 'balance' (human-readable decimal string, e.g. '12.5'), 'raw' (integer string of the smallest unit), 'symbol' (token ticker, e.g. 'USDC'), and 'decimals' (integer, e.g. 6). Useful for displaying or comparing token holdings without manual decimal conversion.

## 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": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "token",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "example": "base",
       "description": "base or ethereum"
      },
      "token": {
       "type": "string",
       "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "ERC-20 contract address"
      },
      "address": {
       "type": "string",
       "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
       "description": "0x EVM address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "12500000",
  "symbol": "USDC",
  "balance": "12.5",
  "decimals": 6
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-balance-lookup-base-ethereum-4a1d5701/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rubycom.ccwu.cc:8443](https://www.zero.xyz/host/rubycom.ccwu.cc%3A8443/llms.txt)