# WalletForge Wallet Balance

> WalletForge Wallet Balance is a paid API for AI agents from api.walletforge.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-25).

Returns the ETH and USDC token balances for a given wallet address on the Base network

## Facts

- Endpoint: POST https://api.walletforge.app/v1/wallet/balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/walletforge-wallet-balance-6c580380
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bt1-Qpoj9AW7arKXo2csS

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 walletforge-wallet-balance-6c580380 -d '<json body>'
```

Example prompt: What's the current ETH and USDC balance on Base for wallet address 0x742d35Cc6634C0532925a3b8D4C9b47f00E3E9A1?

## When to prefer this

Use this endpoint when you need a quick, paid, on-demand lookup of ETH and USDC balances specifically on the Base L2 network for a given Ethereum-format wallet address. Prefer this over building your own RPC calls when you want a simple REST interface without managing Base node connections or handling raw JSON-RPC responses.

## Known failure modes

- Invalid address format (not a valid 0x hex address) — likely returns a 400 or validation error
- Address with no activity on Base — may return zero balances rather than an error
- Network or RPC node unavailability causing timeout or 503
- Rate limiting or payment failure resulting in 402 or 429 response
- Malformed request body missing required address field

## How this service works

WalletForge x402 APIs: normalize text and fetch public URLs as markdown. Pay USDC on Base via HTTP 402. No API key.

## Output

Returns the current ETH and USDC token balances associated with the provided wallet address on the Base network, likely including numeric balance amounts and possibly token metadata or formatted values.

## 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": {
  "eth": {
   "wei": 0,
   "base": 0
  },
  "usdc": {
   "raw": 0,
   "amount": 0,
   "decimals": 6
  },
  "address": "0x...",
  "network": "Base",
  "service": "WalletForge"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/walletforge-wallet-balance-6c580380/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.walletforge.app](https://www.zero.xyz/host/api.walletforge.app/llms.txt)