# AllTheBot Wallet Balance (ETH)

> AllTheBot Wallet Balance (ETH) is a paid API for AI agents from api.zkrobotics.fr, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns live ETH, USDC, and up to 5 ERC-20 token balances for any Ethereum mainnet address

## Facts

- Endpoint: GET https://api.zkrobotics.fr/x402/eth/wallet?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/allthebot-wallet-balance-eth-a758f452
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fLFb9ocvbKRB-hiS2Pv35

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 allthebot-wallet-balance-eth-a758f452
```

Example prompt: What's the current ETH, USDC, and USDT balance of the Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

## When to prefer this

Choose this endpoint when you need live, on-chain Ethereum mainnet wallet balances for ETH and ERC-20 tokens in a single call without managing your own RPC node or API key. It is ideal for agents that need to verify holdings, monitor wallets, or enrich transaction data with current balance context. Prefer it over generic blockchain explorers when you want a lightweight, pay-per-call API with no authentication overhead and structured JSON output.

## Known failure modes

- Invalid Ethereum address format returns a validation error
- Requesting more than 5 ERC-20 token addresses is rejected
- Undeployed or non-ERC-20 contract address may return zero or error
- Network timeouts if Ethereum RPC node is temporarily unavailable
- Payment failure via x402 protocol results in 402 response and no data returned

## How this service works

Pay-per-call APIs for AI agents over x402: token safety reports, Base and Ethereum on-chain reads, crypto prices, domain checks (DNS, WHOIS, SSL, email), finance data (FX, SEC), worldwide weather forecasts, France alerts, text AI, fun content. USDC on Base, no account, no API key.

## Output

A JSON object containing the queried Ethereum address, the network name ('ethereum'), the native ETH balance as a decimal string, and a list of token objects each with the contract address, symbol, human-readable balance, and raw balance integer string. Up to 5 ERC-20 tokens are returned alongside native ETH.

## 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": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "tokens": {
       "type": "array",
       "items": {
        "type": "string",
        "pattern": "^0x[0-9a-fA-F]{40}$"
       },
       "maxItems": 5
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eth": "5.768174715803065014",
  "tokens": [
   {
    "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "symbol": "USDC",
    "balance": "37.192124",
    "balance_raw": "37192124"
   }
  ],
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "network": "ethereum"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allthebot-wallet-balance-eth-a758f452/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zkrobotics.fr](https://www.zero.xyz/host/api.zkrobotics.fr/llms.txt)