# Token Balance (ERC-20 on Base)

> Token Balance (ERC-20 on Base) is a paid API for AI agents from 402.com.tr, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the ERC-20 token balance for a wallet address on Base, with raw units, decimal-adjusted amount, token symbol, and decimals, flagging zero balances and non-ERC-20 contracts explicitly.

## Facts

- Endpoint: GET https://402.com.tr/api/x402/token-balance
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-balance-erc-20-on-base-2e2a11d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kaVcF9Eb1lyHyzFO9Eb5D

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 token-balance-erc-20-on-base-2e2a11d7
```

Example prompt: What's the USDC balance for wallet 0xAbC...123 on Base? Give me both the raw amount and the human-readable decimal value, and let me know if it's zero or if the contract doesn't support balanceOf.

## When to prefer this

Choose this endpoint when you need a single ERC-20 token balance on Base resolved in one call with both raw and decimal-adjusted values, the token symbol, and explicit zero/not-found signaling — avoiding the need for separate multicall or metadata lookups. Prefer it over general portfolio endpoints when you only need one specific token rather than a full multi-token sweep.

## Known failure modes

- Invalid or non-checksummed wallet address returns an error
- Contract address that does not implement balanceOf returns found:false
- Network or RPC timeout results in a failed read
- Malformed query parameters (missing token or wallet) return a validation error
- Token contract on a chain other than Base will not resolve correctly

## How this service works

🆕 An ERC-20 balance on Base, in raw units and in decimals, with the token's symbol and decimals resolved in the same call. Zero is flagged explicitly, since it is the commonest answer and the one most easily confused with a failed read. An address that doesn't implement balanceOf answers found:false and says so.

## Output

Returns the wallet's ERC-20 token balance in raw units (as returned by the contract) and in decimal-adjusted form, along with the token's symbol and decimals. Explicitly flags whether the balance is zero. If the contract address does not implement balanceOf (i.e., is not a valid ERC-20), returns found:false with an explanatory message.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token",
      "wallet"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "Token contract"
      },
      "wallet": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    }
   },
   "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/token-balance-erc-20-on-base-2e2a11d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402.com.tr](https://www.zero.xyz/host/402.com.tr/llms.txt)