# Ambolt Base Wallet Balances

> Ambolt Base Wallet Balances is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Fetches live ETH and ERC-20 token balances for a wallet address on the Base blockchain (chain ID 8453)

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/base-wallet-balances?utm_source=zero.xyz
- Price: $0.005/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-wallet-balances-e4efe686
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zx6E7hlmE4ZFUh5fAeYen

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-wallet-balances-e4efe686
```

Example prompt: What's the current ETH balance and token holdings for wallet 0x4200000000000000000000000000000000000016 on Base mainnet? Also check balances for the USDC contract at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA.

## When to prefer this

Choose this endpoint when you need live, real-time on-chain ETH and token balances specifically on the Base L2 network (chain ID 8453). It supports checking up to 20 additional ERC-20 contracts in a single call, making it efficient for portfolio-style lookups. Prefer this over generic blockchain explorers when you need machine-readable, structured balance data at low cost ($0.005 USDC per call) and need the result immediately without scraping or rate-limit concerns.

## Known failure modes

- Invalid address format (not matching 0x + 40 hex chars) — request rejected by schema validation
- Extra token address not a valid ERC-20 contract — listed in 'unreadable' array rather than hard failure
- More than 20 extra token addresses provided — schema rejects the request
- RPC node unavailability — upstream Base RPC error causing failed or stale response
- Address with zero activity returns zero balances (valid but potentially misleading)

## 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 the wallet's ETH balance in both ETH and wei units, a list of ERC-20 token balances for standard tokens plus any extras requested, the chain ID (8453), network name ('base'), timestamp of the read, and lists of any tokens that could not be read. Data reflects live Base mainnet chain 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": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address on Base."
      },
      "extraTokens": {
       "type": "string",
       "description": "Additional ERC-20 contract addresses to check (up to 20)."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eth": {
   "eth": "371320.35374511097880356",
   "wei": "371320353745110978803560"
  },
  "readAt": "2026-10-02T21:35:41.048Z",
  "source": "Source: Base mainnet RPC (live chain state). Not advice.",
  "tokens": [],
  "address": "0x4200000000000000000000000000000000000016",
  "chainId": 8453,
  "network": "base",
  "unreadable": [],
  "checkedTokens": 7
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ambolt-base-wallet-balances-e4efe686/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)