# kair-os.trade Base Wallet Snapshot

> kair-os.trade Base Wallet Snapshot is a paid API for AI agents from kair-os.trade, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Returns exact integer ETH and ERC-20 token balances for a specified Base address at one finalized block, with optional token metadata and per-token error reporting.

## Facts

- Endpoint: POST https://kair-os.trade/base-wallet/snapshot?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kair-os-trade-base-wallet-snapshot-133e7b4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_crZmf9dtgd4cahEt3dZqI

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 kair-os-trade-base-wallet-snapshot-133e7b4a -d '<json body>'
```

Example prompt: Check the exact ETH balance and balances for USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and WETH (0x4200000000000000000000000000000000000006) held by Base address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 at the latest finalized block.

## When to prefer this

Choose this endpoint when you need precise, raw integer token balances for a known set of ERC-20 contracts on Base at a finalized block, without needing token discovery or price data. It is ideal for auditing specific positions, verifying holdings before a trade, or recording a historical snapshot. Prefer alternatives if you need price estimates, token discovery across an unknown portfolio, or multi-chain support.

## Known failure modes

- Invalid or zero Base wallet address returns a validation error
- Invalid ERC-20 contract addresses (not matching 0x hex pattern) are rejected
- More than 20 token addresses in a single request returns a validation error
- Non-ERC-20 contract addresses produce per-token errors rather than balances
- RPC or node unavailability may cause the entire request to fail
- Duplicate token addresses (case-insensitive) may be deduplicated or rejected

## How this service works

Read ETH and caller-selected ERC-20 balances for a Base address at one finalized block. Exact integer amounts, optional contract-reported metadata, explicit per-token errors. No token discovery or price estimates.

## Output

Returns exact integer ETH balance and per-token integer balances for each requested ERC-20 contract address at a single finalized Base block. Also includes optional contract-reported token metadata (name, symbol, decimals) and explicit error entries for any tokens that could not be queried. No token discovery, price estimates, or USD values are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[0-9a-fA-F]{40}$"
   },
   "maxItems": 20,
   "minItems": 1,
   "description": "1–20 unique nonzero ERC-20 contract addresses; duplicate comparison is case-insensitive.",
   "uniqueItems": true
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Nonzero Base wallet address."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kair-os-trade-base-wallet-snapshot-133e7b4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kair-os.trade](https://www.zero.xyz/host/kair-os.trade/llms.txt)