# signals.edge.report ERC20 Token Balance Lookup

> signals.edge.report ERC20 Token Balance Lookup is a paid API for AI agents from signals.edge.report, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the ERC20 token balance, decimals, and symbol for any wallet address and token contract on Base or Ethereum.

## Facts

- Endpoint: GET https://signals.edge.report/v1/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/signals-edge-report-erc20-token-balance-lookup-f58206d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FN10tXyUNbH9uLE9_kirK

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 signals-edge-report-erc20-token-balance-lookup-f58206d3
```

Example prompt: What's the USDC balance for wallet 0xAbC...123 on Base right now? Pull it from the ERC20 balanceOf call using the USDC contract address.

## When to prefer this

Choose this endpoint when you need a fast, keyless, on-chain ERC20 balance check on Base or Ethereum without setting up your own RPC connection. It is ideal for AI agents operating in DeFi workflows that need live token holdings data before executing swaps, payments, or risk assessments. Prefer it over full wallet bundle endpoints when you only need a single token balance rather than a multi-asset snapshot.

## Known failure modes

- Invalid or malformed wallet address returns an error or zero balance
- Invalid token contract address (non-ERC20 or wrong chain) causes a failed call or empty result
- Unsupported chain value returns an error
- Network congestion or RPC unavailability may cause timeouts
- Payment failure (x402) blocks the request if USDC balance is insufficient

## How this service works

Get ERC20 token balance for any wallet and token contract on Base (or Ethereum). Returns balance, decimals, and symbol via balanceOf. Use for live ERC20 holdings checks without an API key.

## Output

Returns a JSON object containing the token balance (as a raw integer or decimal-adjusted number), the token's decimal places, and the token symbol — representing the live on-chain ERC20 holdings of the specified wallet.

## 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": {
       "type": "string",
       "description": "Chain: base (default) or ethereum"
      },
      "token": {
       "type": "string",
       "description": "ERC20 token contract address"
      },
      "address": {
       "type": "string",
       "description": "Wallet address to read ERC20 balance for"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "wallet": "0x0000000000000000000000000000000000000001",
  "balance": "12.5",
  "product": "edge-signals-erc20-balance",
  "decimals": 6,
  "balanceRaw": "12500000"
 }
}
```

## More

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