# ERC20 Token Balance Lookup

> ERC20 Token Balance Lookup is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-27).

Returns the ERC-20 token balance for a given wallet address on Ethereum, Base, Arc, or BNB Chain

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/evm-token-balance?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-token-balance-lookup-b3e6b431
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_72wulKhUxKxrYrIiPTzGl

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-lookup-b3e6b431
```

Example prompt: What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum? The USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

## When to prefer this

Use this endpoint when you need a quick, cheap ($0.001) on-chain ERC-20 token balance lookup across Ethereum, Base, Arc, or BNB Chain without setting up your own RPC infrastructure. Ideal for agents that need real-time wallet token holdings as part of DeFi workflows, portfolio checks, or eligibility verification.

## Known failure modes

- Invalid wallet address format (must be 0x + 40 hex chars) returns an error
- Invalid token contract address format returns an error
- Unsupported chain name returns an error
- Token contract does not exist on specified chain may return zero balance or error
- Network timeout or RPC node failure may return a non-ok response

## How this service works

Free APEX on X1, and free USDC plus APEX on Arc, three times a day. No gas, no sign-up. Plus a swap, a screener, APEX City and token checks.

## Output

Returns a JSON object with ok status, and a data object containing the human-readable balance (with decimals applied), the raw integer balance, token name, symbol, decimals, the chain queried, the block number and timestamp at which the balance was read, plus the wallet and token contract addresses. Also includes the amount paid for the API call.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arc",
        "bnb"
       ],
       "type": "string",
       "description": "Chain to read: ethereum, base, arc or bnb. Default ethereum."
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 token contract."
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet whose balance to read."
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "data": {
    "type": "object"
   },
   "paid": {
    "type": "number"
   }
  }
 },
 "example": {
  "ok": true,
  "data": {
   "ok": true,
   "raw": "37192124",
   "name": "USD Coin",
   "block": 26184706,
   "chain": "ethereum",
   "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
   "symbol": "USDC",
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "balance": "37.192124",
   "decimals": 6,
   "blockTime": "2026-10-13T16:16:23.000Z"
  },
  "paid": 0.001
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-token-balance-lookup-b3e6b431/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apexfaucet.xyz](https://www.zero.xyz/host/apexfaucet.xyz/llms.txt)