# HALOWERK kettenwerk Wallet Balances

> HALOWERK kettenwerk Wallet Balances is a paid API for AI agents from kette.netzhandwerker.de, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Retrieves token balances for a given wallet address across multiple EVM chains, grouped by asset or chain.

## Facts

- Endpoint: POST https://kette.netzhandwerker.de/wallet/balances
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-wallet-balances-b9fd71e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_twC047tZXG-7AUeaAnypM

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 halowerk-kettenwerk-wallet-balances-b9fd71e7 -d '<json body>'
```

Example prompt: What are the token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across Ethereum, Base, Arbitrum, and Optimism — group the results by asset?

## When to prefer this

Choose this endpoint when you need to aggregate EVM wallet token balances across Ethereum mainnet and major L2s (Base, Arbitrum, Optimism) in a single call with flexible grouping. It is well-suited for portfolio snapshots, treasury audits, and automated balance checks where multi-chain coverage is needed without building per-chain RPC integrations yourself. It is a paid x402 endpoint, making it appropriate for production agent workflows that can handle micropayments in USDC on Base.

## Known failure modes

- Invalid wallet address format (not 0x + 40 hex chars) returns validation error
- More than 4 chains specified exceeds maxItems limit
- Unsupported or misspelled chain names may return empty results or errors
- Payment failure (insufficient USDC on Base Mainnet) blocks the request via x402
- Network timeout if queried chains are slow to respond
- Wallet with zero activity may return empty balance lists

## How this service works

HALOWERK kettenwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns token balances for the specified wallet address, organized by both asset and chain. The primary grouping dimension (asset or chain) is specified by group_by, but both dimensions are always included. Each entry typically shows token symbol, amount, and chain context.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 4,
   "description": "Chains to query. Default: ethereum, base, arbitrum, optimism."
  },
  "wallet": {
   "type": "string",
   "description": "Wallet address, 0x followed by 40 hex characters."
  },
  "group_by": {
   "enum": [
    "asset",
    "chain"
   ],
   "type": "string",
   "default": "asset",
   "description": "Which grouping to put first. Both are always returned."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-wallet-balances-b9fd71e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.netzhandwerker.de](https://www.zero.xyz/host/kette.netzhandwerker.de/llms.txt)