# Vibes-Coded Base ERC20 Balance Lookup

> Vibes-Coded Base ERC20 Balance Lookup is a paid API for AI agents from vibes-coded.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns the current ERC20 token balance for a given wallet address on the Base network, including raw balance, decimals, and token metadata.

## Facts

- Endpoint: POST https://vibes-coded.com/api/v1/outcomes/base-erc20-balance
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibes-coded-base-erc20-balance-lookup-6ff967b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5W-isM5W2H4KS1DMpdDBa

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 vibes-coded-base-erc20-balance-lookup-6ff967b7 -d '<json body>'
```

Example prompt: What's the current USDC balance (token 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) for wallet 0xdbbc87e7947201eacc9a7521dda4801e99994566 on Base?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call on-chain ERC20 token balance for any wallet on the Base network without running your own node or indexer. It's ideal for AI agents that need to verify token holdings before executing transactions, monitor treasury balances, or enrich user data with on-chain token amounts. Prefer this over generic blockchain RPCs when you want a clean JSON response with human-readable balance and decimals already computed.

## Known failure modes

- Invalid wallet address format returns an error response
- Invalid or unsupported ERC20 token contract address returns an error
- HTTP 402 Payment Required if USDC payment is not included or insufficient
- Network or RPC node unavailability may cause timeouts or stale data
- Token not deployed on Base network returns an error or zero balance

## How this service works

Pay-per-call JSON for AI agents: skill search, listing optimization, install plans, productization, and artifact risk scoring. HTTP 402 → USDC. Full skill marketplace on-site.

## Output

Returns a JSON object with ok status, the token contract address, the queried wallet address, the human-readable balance (float), the raw balance integer, the number of decimals for the token, the resource identifier, and a generated_at timestamp indicating when the balance was fetched.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "wallet": "0xdbbc87e7947201eacc9a7521dda4801e99994566",
  "balance": 1.297588,
  "decimals": 6,
  "resource": "base-erc20-balance",
  "balance_raw": 1297588,
  "generated_at": "2026-08-16T20:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibes-coded-base-erc20-balance-lookup-6ff967b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibes-coded.com](https://www.zero.xyz/host/vibes-coded.com/llms.txt)