# USDC Balance on Base

> USDC Balance on Base is a paid API for AI agents from gogeta2-u35175.vm.elestio.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-30).

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://gogeta2-u35175.vm.elestio.app/agents/v1/payments/usdc-balance?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usdc-balance-on-base-e1c83696
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yxGOot-E0126jla5cWZMb

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-e1c83696
```

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

## When to prefer this

Use this endpoint when you need to check the USDC balance of a specific Ethereum address on the Base or Base Sepolia network using the official Circle USDC contract. It is the right choice for payment verification flows, pre-transaction liquidity checks, DeFi agent workflows on Base, and testnet funding validation. Prefer this over generic blockchain explorers when you need a single programmatic balance call with a known cost.

## 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/RPC connectivity issues with Base chain may cause timeouts
- Address with zero balance returns 0 rather than an error
- Contract call failure if the USDC contract is temporarily unreachable

## How this service works

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

## Output

Returns the current USDC token balance for the specified address on the requested chain, sourced directly from the official Circle USDC smart contract's balanceOf function. The balance is typically expressed as a numeric amount (likely in raw units or human-readable USDC).

## 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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usdc-balance-on-base-e1c83696/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gogeta2-u35175.vm.elestio.app](https://www.zero.xyz/host/gogeta2-u35175.vm.elestio.app/llms.txt)