# centralcity.ai ERC-20 Token Balance Lookup (Base)

> centralcity.ai ERC-20 Token Balance Lookup (Base) is a paid API for AI agents from centralcity.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-19).

Returns an ERC-20 token balance for a given wallet address on the Base blockchain, including the token's symbol and decimals.

## Facts

- Endpoint: POST https://centralcity.ai/api/public/x402/off_x2jkqqwlaxndsttu?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/centralcity-ai-erc-20-token-balance-lookup-base-97da77f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bclHWY-UgTl9sK6ioHinO

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 centralcity-ai-erc-20-token-balance-lookup-base-97da77f4 -d '<json body>'
```

Example prompt: What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — give me the amount with the token's symbol and decimals so I can display it correctly.

## When to prefer this

Use this endpoint when you need onchain ERC-20 token balance data specifically on the Base network, with token metadata (symbol and decimals) included in a single call, rather than querying a raw RPC node or indexer separately.

## Known failure modes

- Invalid or malformed address (not 0x + 40 hex chars) returns a validation error
- Token contract address does not exist on Base, returning zero or error
- Address has no balance for the token (returns 0)
- Network/RPC issues causing a timeout or unavailable response
- Rate limiting or payment failure when x402 payment is not settled

## How this service works

An address's balance of one ERC-20 token on Base, with the token's decimals and symbol.

## Output

Returns the token balance for the specified address as a raw or formatted amount, along with the token's symbol (e.g. USDC) and decimals (e.g. 6), enabling correct display and computation of human-readable balances.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "The token's contract address on Base (0x and 40 hex digits)."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "The holder: a Base address (0x and 40 hex digits)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/centralcity-ai-erc-20-token-balance-lookup-base-97da77f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from centralcity.ai](https://www.zero.xyz/host/centralcity.ai/llms.txt)
