# Base USDC Balance Lookup

> Base USDC Balance Lookup is a paid API for AI agents from x402-46-225-191-113.sslip.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-23).

Fetches the block-pinned USDC token balance for a given Ethereum-compatible address on Base (chain ID 8453)

## Facts

- Endpoint: POST https://x402-46-225-191-113.sslip.io/v1/base-usdc-balance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-usdc-balance-lookup-47b665f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0rOAhPIYvVR__edjeLAXn

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 base-usdc-balance-lookup-47b665f3 -d '<json body>'
```

Example prompt: What's the current USDC balance on Base for the wallet address 0xabababababababababababababababababababab? I need the block-pinned amount and finality status.

## When to prefer this

Use this endpoint when you need a block-pinned, on-chain USDC balance reading for a specific wallet on Base (chain ID 8453) with explicit finality metadata. Prefer this over generic blockchain explorers when you need structured JSON output with atomic amounts, block hash, timestamp, and finality status in a single call, especially in automated agent workflows that require verifiable snapshot data.

## Known failure modes

- Invalid or malformed address (not matching ^0x[0-9a-fA-F]{40}$) returns a validation error
- RPC provider unavailability may cause timeout or 5xx error
- Payment of 0.003 USDC not provided via x402 results in 402 Payment Required
- Address has no USDC holdings — returns 0 balance with valid block metadata
- Block reorganization may make snapshot stale immediately after read

## How this service works

Temporary UTF-8 file handoff, cited HTTPX migration evidence and block-pinned Base USDC balances. See each route for its price, limits and output contract.

## Output

Returns a JSON object with the USDC token contract address, the wallet's atomic and decimal USDC amounts, the block number and hash at which the read occurred, block timestamp, finality status (including finalized block hash and whether the read block is at or below the finalized block), RPC source URL, consistency method, number of read calls made, and an array of stated limitations about the single-provider nature of the reading and absence of USD valuation or proof-of-payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "status": "ok",
  "symbol": "USDC",
  "address": "0xabababababababababababababababababababab",
  "network": "eip155:8453",
  "read_at": "2026-10-21T18:00:00+00:00",
  "chain_id": 8453,
  "decimals": 6,
  "finality": {
   "status": "unfinalized",
   "finalized_block_hash": "0x3434343434343434343434343434343434343434343434343434343434343434",
   "at_or_below_finalized": false,
   "finalized_block_at_observation": 90
  },
  "block_hash": "0x1212121212121212121212121212121212121212121212121212121212121212",
  "read_calls": 6,
  "rpc_source": "https://example.invalid",
  "consistency": "explicit block number with number/hash/timestamp rechecked after reads",
  "limitations": [
   "Single RPC provider assertion; no independent-node corroboration, ancestry verification or Merkle proof.",
   "A latest-block snapshot can be reorganized or superseded; finality is the provider's observation, not an independent guarantee.",
   "Token quantity only: no USD valuation, transaction history, source-of-funds determination or proof of invoice payment."
  ],
  "block_number": 100,
  "atomic_amount": "1234567",
  "decimal_amount": "1.234567",
  "block_timestamp": "2026-10-21T18:00:00+00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-usdc-balance-lookup-47b665f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-46-225-191-113.sslip.io](https://www.zero.xyz/host/x402-46-225-191-113.sslip.io/llms.txt)