# ProofSignal ERC-20 Token Balance (Base Mainnet)

> ProofSignal ERC-20 Token Balance (Base Mainnet) is a paid API for AI agents from enough-kate-provide-bennett.trycloudflare.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the live ERC-20 token balance for a wallet or contract address on Base mainnet, including token symbol, decimals, atomic amount, human-readable amount, and current block.

## Facts

- Endpoint: GET https://enough-kate-provide-bennett.trycloudflare.com/base/erc20-balance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proofsignal-erc-20-token-balance-base-mainnet-5b97a725
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_KXfj46vJ-3p3DWGvc4P

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 proofsignal-erc-20-token-balance-base-mainnet-5b97a725
```

Example prompt: What's the current USDC balance of wallet 0xAbC123...def456 on Base mainnet? I need the human-readable amount, atomic amount, token decimals, and which block it was read from.

## When to prefer this

Use this endpoint when you need a real-time, single-call lookup of an ERC-20 token balance on Base mainnet with full token metadata (symbol, decimals, atomic and human-readable amounts) and the current block context. Prefer it over generic blockchain explorers when you need structured programmatic output ready for agent pipelines. Choose it over Ethereum mainnet balance endpoints specifically for Base L2 balances.

## Known failure modes

- Invalid or non-checksummed token contract address returns an error or zero balance
- Invalid wallet address format causes a 400-level error
- Token address is not a valid ERC-20 contract on Base mainnet, returning an error or empty response
- Network congestion or RPC node issues may cause timeouts
- Trycloudflare tunnel may be ephemeral and go offline, returning connection errors

## How this service works

Live Base ERC-20 token balance with token symbol, decimals, atomic amount, human-readable amount, and current block.

## Output

Returns a JSON object containing the ERC-20 token symbol, number of decimals, raw atomic balance (BigInt string), human-readable balance (decimal string), and the current Base mainnet block number at which the balance was recorded.

## 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": [
      "token",
      "address"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "0x-prefixed ERC-20 token contract address on Base mainnet"
      },
      "address": {
       "type": "string",
       "description": "0x-prefixed wallet or contract address whose token balance should be read"
      }
     },
     "additionalProperties": false
    }
   },
   "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/proofsignal-erc-20-token-balance-base-mainnet-5b97a725/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from enough-kate-provide-bennett.trycloudflare.com](https://www.zero.xyz/host/enough-kate-provide-bennett.trycloudflare.com/llms.txt)