# Ambolt Base ERC-20 Token Balance Lookup

> Ambolt Base ERC-20 Token Balance Lookup is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Retrieves the ERC-20 token balance for a given wallet address on the Base blockchain network.

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/base-erc20-balance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ambolt-base-erc-20-token-balance-lookup-f48e5159
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vOTeIsQMhyR73P8Z_JmYY

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 ambolt-base-erc-20-token-balance-lookup-f48e5159
```

Example prompt: What's the USDC balance for wallet 0x4200000000000000000000000000000000000016 on Base? The USDC contract address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.

## When to prefer this

Choose this endpoint when you need a real-time, on-chain ERC-20 token balance for any wallet on the Base network specifically. It is ideal for DeFi automation, payment eligibility checks, portfolio monitoring, or any agentic workflow that must verify holdings before executing a transaction. Prefer this over generic blockchain RPCs when you want a structured, parsed response (human-readable balance plus decimals) without writing raw RPC calls.

## Known failure modes

- Invalid wallet address format (not a valid 0x Ethereum address) returns an error
- Invalid token contract address (not a deployed ERC-20 on Base) may return zero balance or error
- Network/RPC outage on Base may cause timeout or stale data
- Payment failure (insufficient USDC for x402 fee) blocks the request
- Requesting a token address that is not an ERC-20 contract returns unexpected results

## How this service works

Pay-per-call data tools for developers and AI agents: company registers, documents, tenders, rates and on-chain facts as MCP tools, x402 endpoints and Apify Actors.

## Output

Returns a JSON object containing the token name, symbol, decimals, the human-readable balance, the raw on-chain balance (in base units), the wallet address, the token contract address, the Base chain ID (8453), the network name, and a timestamp indicating when the balance was read.

## 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": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address",
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC-20 token contract address on Base."
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "readAt": "2026-10-02T21:35:40.251Z",
  "symbol": "USDC",
  "address": "0x4200000000000000000000000000000000000016",
  "balance": "0",
  "chainId": 8453,
  "network": "base",
  "decimals": 6,
  "balanceRaw": "0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ambolt-base-erc-20-token-balance-lookup-f48e5159/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ambolt.dev](https://www.zero.xyz/host/api.ambolt.dev/llms.txt)