# SiteCheck EVM ERC-20 Token Balance

> SiteCheck EVM ERC-20 Token Balance is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Fetches the ERC-20 token balance for a given EVM wallet address on a specified chain, including USD value

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/evm/balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-evm-erc-20-token-balance-60540a98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fjeZGPXtMkm41JCtCWYkS

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 sitecheck-evm-erc-20-token-balance-60540a98
```

Example prompt: What's the USDC balance (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base, and what is it worth in USD right now?

## When to prefer this

Choose this endpoint when you need the ERC-20 token balance for a specific wallet on an EVM-compatible chain (Base, Ethereum, Arbitrum, Optimism, Polygon) along with real-time USD valuation in a single call. It is ideal for agents that need to check portfolio balances, verify token holdings, or assess DeFi positions without building their own RPC infrastructure. Prefer it over raw RPC calls when you also want token metadata and USD conversion bundled together.

## Known failure modes

- Invalid or non-checksummed EVM address returns an error
- Unrecognized or unsupported chain name defaults to Base or returns error
- ERC-20 contract address not found on specified chain returns null balance or error
- RPC node unavailability causes timeout or 503
- Token with no Coinbase price feed returns USD value as null
- Missing required query parameters (address or token) returns 400

## How this service works

ERC-20 balance of an address for one token contract on a chain: token name, symbol, decimals, raw and human amount, and a USD value when Coinbase has a spot price for the symbol. Only the token you name is read; the native balance is in /api/evm/address.

## Output

Returns a JSON object with the raw token balance (integer string), human-readable amount, token metadata (name, symbol, contract address, decimals), the holder address, chain identifier, USD spot price, total USD value, the RPC source used, and a timestamp of when the check was performed.

## 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": "base (default), ethereum, arbitrum, optimism or polygon"
      },
      "token": {
       "type": "string",
       "description": "ERC-20 contract address, 0x…"
      },
      "address": {
       "type": "string",
       "description": "EVM address, 0x…"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": "44783666",
  "chain": "base",
  "token": {
   "name": "USD Coin",
   "symbol": "USDC",
   "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "decimals": 6
  },
  "amount": 44.783666,
  "holder": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "source": "https://base-rpc.publicnode.com (eth_call name, symbol, decimals, balanceOf); Coinbase spot price for the symbol",
  "usdPrice": 1,
  "usdValue": 44.78,
  "checkedAt": "2026-10-14T04:49:18.151Z",
  "disclaimer": "Information only, not financial advice."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-evm-erc-20-token-balance-60540a98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)