# USDC Balance Lookup on Base

> USDC Balance Lookup on 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 the USDC token balance of a given Ethereum address on the Base blockchain network.

## Facts

- Endpoint: POST https://centralcity.ai/api/public/x402/off_pqnidpd6mbpql7ub?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/usdc-balance-lookup-on-base-36b83ab2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7b-fRIFfCnyq1ozTnfa7d

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 usdc-balance-lookup-on-base-36b83ab2 -d '<json body>'
```

Example prompt: What's the USDC balance of the wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Base?

## When to prefer this

Use this endpoint when you need a simple, pay-per-call lookup of a wallet's USDC balance specifically on the Base network, without setting up your own RPC node or indexer. It is ideal for lightweight agent workflows that occasionally need to verify stablecoin balances, confirm payment receipt, or gate access based on wallet holdings, and where the $0.05 cost per call is acceptable.

## Known failure modes

- Invalid or malformed address (not matching 0x + 40 hex digits) returns a validation error
- Address with no USDC balance returns zero rather than an error
- Network or RPC node issues may cause timeouts or stale data
- Non-Base addresses (e.g. Ethereum mainnet-only addresses) return zero if they hold no Base USDC
- Payment failure (insufficient USDC for the $0.05 call fee) prevents the request from being processed

## How this service works

The USDC balance of an address on Base.

## Output

Returns the USDC token balance held by the specified address on the Base network, typically as a numeric value representing the amount of USDC (likely in human-readable units or raw wei/microunits depending on the API response format).

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usdc-balance-lookup-on-base-36b83ab2/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)
