# USDC Balance Lookup on Base

> USDC Balance Lookup on Base is a paid API for AI agents from shop.northheart.app, paid per call via x402, $0.005/call, status down (last checked 2026-11-22).

Returns the USDC (digital-dollar) balance of a given Base blockchain address

## Facts

- Endpoint: POST https://shop.northheart.app/lookup/usdc-balance?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-11-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usdc-balance-lookup-on-base-3da46896
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yvTiDYzy9DDgb0eMHqgWP

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-3da46896 -d '<json body>'
```

Example prompt: What's the USDC balance on Base for the wallet address 0x1234abcd...? I want to know exactly how many digital dollars it's holding.

## When to prefer this

Use this endpoint when you need a quick, cheap on-chain USDC balance check for a Base address without running your own RPC node. Ideal for AI agents needing to verify wallet funding before executing payments, monitor treasury levels, or confirm counterparty balances on Base L2. Costs only $0.005 USDC per call via x402 micropayment.

## Known failure modes

- Invalid or malformed Base address returns an error
- Address with no USDC holdings returns a zero balance
- Network or RPC issues may cause lookup failures
- Request missing the target address returns a validation error

## How this service works

Digital-dollar (USDC) balance of a Base address

## Output

The endpoint returns the USDC balance (as a numeric amount in human-readable digital-dollar units) held by the specified Base blockchain address, read directly from the on-chain ERC-20 token contract state.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string"
      },
      "read_from": {
       "type": "string"
      },
      "usdc_balance": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usdc-balance-lookup-on-base-3da46896/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from shop.northheart.app](https://www.zero.xyz/host/shop.northheart.app/llms.txt)
