# Base ERC20 Token Balance

> Base ERC20 Token Balance is a paid API for AI agents from appearing-clinics-show-wrote.trycloudflare.com, paid per call via x402, price unknown, status down (last checked 2026-09-15).

Reads any ERC-20 token balance on the Base blockchain for a given wallet address and contract, returning the balance with proper decimal normalization.

## Facts

- Endpoint: GET https://appearing-clinics-show-wrote.trycloudflare.com/base-token-balance-sample
- Price: price unknown
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-erc20-token-balance-860aebd4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L_QHkrPJUCBVsPGxkDe7P

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 base-erc20-token-balance-860aebd4
```

Example prompt: What's the USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? Use the ERC-20 contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.

## When to prefer this

Use this endpoint when you need to read an ERC-20 token balance specifically on the Base L2 network with decimal normalization included. Prefer it over generic Ethereum balance APIs when the token is on Base, and over Base native ETH balance endpoints when you need an ERC-20 (non-native) token. The bounded contract-code check adds lightweight validation that the contract is a real ERC-20.

## Known failure modes

- Invalid or non-existent contract address returns an error or zero balance
- Wallet address not checksummed or malformed causes a rejection
- Contract does not implement ERC-20 balanceOf or decimals — returns error
- Network congestion on Base may cause timeout
- Free sample endpoint returns only a fixed sample (USDC receiver balance); full arbitrary address/contract lookup requires the paid $0.0025 tier

## How this service works

Free Base USDC balance sample for the service receiver. The paid $0.0025 API reads any Base ERC-20 balance with bounded contract-code, balanceOf, and decimals calls.

## Output

Returns the ERC-20 token balance for the specified wallet and contract on Base, including the raw balanceOf result, the token's decimal places, and the human-readable normalized balance amount.

## 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": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-erc20-token-balance-860aebd4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from appearing-clinics-show-wrote.trycloudflare.com](https://www.zero.xyz/host/appearing-clinics-show-wrote.trycloudflare.com/llms.txt)