# USDC Balance on Base

> USDC Balance on Base is a paid API for AI agents from api.novarithm.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-11).

Returns the current USDC token balance of an Ethereum address on Base mainnet or Base Sepolia testnet by calling the official Circle USDC contract's balanceOf function.

## Facts

- Endpoint: GET https://api.novarithm.com/agents/v1/payments/usdc-balance?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usdc-balance-on-base-f7025ffc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pgU92Wx7Y4pxgqJJZa2be

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-on-base-f7025ffc
```

Example prompt: What's the current USDC balance for the wallet address 0x1234...abcd on Base mainnet?

## When to prefer this

Use this endpoint when you need a fast, reliable, on-chain USDC balance lookup for any address on Base mainnet or Base Sepolia, backed by the official Circle contract. Prefer this over general blockchain explorers or multi-chain balance APIs when you specifically need USDC on Base and want a simple, agent-friendly REST interface without managing your own RPC provider.

## Known failure modes

- Invalid or malformed Ethereum address (non-0x format) returns an error
- Unsupported chain value other than 'base' or 'base-sepolia' returns a validation error
- Network or RPC node unavailability may cause timeout or 503
- Address with no USDC holdings returns a zero balance (not an error)
- Rate limiting or payment failure ($0.001 USDC per call) may block the request

## How this service works

Current USDC balance of an address on Base or Base Sepolia (balanceOf on the official Circle contract).

## Output

Returns the USDC token balance (balanceOf) for the specified address on Base mainnet or Base Sepolia, sourced directly from the official Circle USDC contract. The response includes the balance amount, typically expressed in USDC token units (with 6 decimal places).

## 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"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "base-sepolia"
       ],
       "type": "string",
       "default": "base",
       "description": "base (default) or base-sepolia"
      },
      "address": {
       "type": "string",
       "description": "Address (0x...)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "chain": "base",
   "source": "eth_call balanceOf on the official USDC contract",
   "address": "0xe414ad5c7542ce63d890526f0e2133ff8da6f22d",
   "sources": [
    {}
   ],
   "chain_id": 8453,
   "price_usd": 0.001,
   "balance_raw": "0",
   "billing_unit": "address",
   "block_number": 52980236,
   "generated_at": "2026-10-23T10:03:40Z",
   "usdc_balance": 0,
   "usdc_contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
   "response_time_ms": 227
  },
  "service": "usdc_balance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usdc-balance-on-base-f7025ffc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.novarithm.com](https://www.zero.xyz/host/api.novarithm.com/llms.txt)
