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

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

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

## Facts

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

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-f0a3ed63
```

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

## When to prefer this

Choose this endpoint when you need a quick, no-account ERC-20 token balance lookup on Base or Ethereum and want to pay per-call in USDC via x402 without setting up API credentials. Ideal for agents that need on-demand, low-frequency balance checks without committing to a subscription or API key.

## Known failure modes

- Invalid or malformed EVM address returns an error
- Unsupported chain value (only 'base' or 'ethereum' accepted)
- Invalid ERC-20 contract address returns an error or zero balance
- Network/RPC timeout causes delayed or failed response
- Payment failure via x402 prevents request from being processed

## 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 the wallet's token balance formatted for human reading (e.g. '12.5'), the raw integer balance, the token symbol (e.g. 'USDC'), and the number of decimals used by the token contract.

## 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-f0a3ed63/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from superstone.ccwu.cc:8443](https://www.zero.xyz/host/superstone.ccwu.cc%3A8443/llms.txt)