# ERC20 Token Balance Checker (Base/Ethereum/Arbitrum/Optimism/Polygon)

> ERC20 Token Balance Checker (Base/Ethereum/Arbitrum/Optimism/Polygon) is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-12).

Returns the ERC20 token balance for a wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon — including raw amount, decimal-formatted balance, symbol, decimals, and block number.

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/chain/erc20-balance?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-token-balance-checker-base-ethereum-arbitrum-optimism-polygon-eeb1fcc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PdnoEOBjP5zzNtSv0pcQ1

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 erc20-token-balance-checker-base-ethereum-arbitrum-optimism-polygon-eeb1fcc3
```

Example prompt: What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — give me both the formatted amount and the raw value?

## When to prefer this

Use this endpoint when you need a quick, cheap ($0.001) on-chain ERC20 balance lookup across the five major EVM chains (Base, Ethereum, Arbitrum, Optimism, Polygon) with both raw and decimal-formatted output in a single call. It is ideal for DeFi agents, portfolio trackers, and pre-trade checks. Prefer this over manually calling an RPC node when you want symbol and decimals returned alongside the balance without additional contract calls.

## Known failure modes

- Invalid wallet or token address format (must match ^0x[0-9a-fA-F]{40}$) → likely 400 error
- Unsupported chain name → rejected by enum validation
- Token contract address is not a valid ERC20 contract → may return zero or error
- RPC node unavailable for the target chain → upstream timeout or 5xx
- Wallet has no balance for that token → returns '0' (not an error)

## How this service works

ERC20 token balance for any wallet on Base/Ethereum/Arbitrum/Optimism/Polygon via balanceOf (eth_call). Returns raw + decimal-formatted balance, symbol, decimals, block. Example: {address:"0xd8dA…6045", token:"0x8335…2913", chain:"base"}. $0.001.

## Output

A JSON object containing: formatted decimal balance (e.g. '81.809468'), raw integer balance string (e.g. '81809468'), token symbol (e.g. 'USDC'), decimals (e.g. 6), block number at which the balance was read, chain name, chain ID, wallet address, and token contract address.

## 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": [
      "address",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC20 contract"
      },
      "wallet": {
       "type": "string",
       "description": "Alias for address (owner wallet)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "block": {
       "type": "number"
      },
      "symbol": {
       "type": "string"
      },
      "balance": {
       "type": "string"
      },
      "decimals": {
       "type": "number"
      },
      "balance_raw": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "block": 53552081,
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "source": "eth_call balanceOf",
  "symbol": "USDC",
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "balance": "81.809468",
  "chain_id": 8453,
  "decimals": 6,
  "balance_raw": "81809468"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-token-balance-checker-base-ethereum-arbitrum-optimism-polygon-eeb1fcc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
