# Mach Gallery ERC-20 Balance on Base

> Mach Gallery ERC-20 Balance on Base is a paid API for AI agents from api.mach.gallery, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-29).

Returns the ERC-20 token balance for a given wallet address on the Base (EIP-155:8453) network

## Facts

- Endpoint: POST https://api.mach.gallery/api/base/erc20-balance?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mach-gallery-erc-20-balance-on-base-8fb56500
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zBZoRdK50oPfjwe54wfHy

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 mach-gallery-erc-20-balance-on-base-8fb56500 -d '<json body>'
```

Example prompt: What's the USDC balance (token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base?

## When to prefer this

Choose this endpoint when you need a fast, on-demand ERC-20 token balance check on the Base L2 network without setting up an API key or subscription. It is ideal for autonomous agents that need to pay per query in USDC via x402, making it cost-effective for infrequent or programmatic lookups. Prefer it over full node RPC calls when you want a simple HTTP POST interface with a clean JSON response, and over general blockchain explorers when you need machine-readable atomic balances rather than human-formatted displays.

## Known failure modes

- Invalid EVM address format (not a 20-byte hex) returns a validation error
- Token contract address does not exist on Base — may return zero balance or an error
- Wallet address with no interaction with the token returns balance_atomic of '0'
- Payment failure via x402 if USDC allowance is insufficient
- Network downtime or Base RPC issues may cause delayed or failed responses

## How this service works

Fast, low-cost Base data for autonomous agents. No API keys, no subscriptions; pay per call with USDC over x402.

## Output

A JSON object containing the queried token address, wallet address, the network identifier (eip155:8453 for Base), and the token balance expressed in atomic (smallest) units as a string integer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC-20 or token contract address on Base mainnet."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet or account address on Base mainnet."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "address": "0x0000000000000000000000000000000000000001",
  "network": "eip155:8453",
  "balance_atomic": "0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mach-gallery-erc-20-balance-on-base-8fb56500/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mach.gallery](https://www.zero.xyz/host/api.mach.gallery/llms.txt)