# AgentsTools Wallet Balances

> AgentsTools Wallet Balances is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns native-coin and ERC-20 token balances (raw and human-readable) for any wallet address on Base, Ethereum, Arbitrum, Optimism, Polygon, or BNB Chain

## Facts

- Endpoint: GET https://api.agentstools.dev/wallet/balances
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstools-wallet-balances-4df0465a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JMwniK4B8T8c_VonAQ0s8

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 agentstools-wallet-balances-4df0465a
```

Example prompt: Can you check the ETH and USDC balances — both raw and human-readable, plus USD values — for wallet 0xAbC123...def on Base?

## When to prefer this

Use this endpoint when you need on-chain token balances across major EVM networks for any wallet address, especially on Base where token symbols are supported and USD values are available. Prefer this over block explorer scraping when you need clean raw+human-readable amounts in a single API call. Useful in DeFi agents, portfolio trackers, compliance checks, or any workflow that needs to verify a wallet's holdings before executing a transaction.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported network name returns a validation error
- More than 25 tokens specified returns an error
- Explicit 0x token addresses required on non-Base networks (symbols not supported)
- Network RPC timeout may return a 503 or partial result
- USD values only available on Base; ignored silently on other networks

## How this service works

Native-coin balance + ERC-20 token balances (raw + human) for any address on Base, Ethereum, Arbitrum, Optimism, Polygon or BNB (default Base). On Base pass token symbols or 0x addresses (or a default common set); on other networks pass explicit 0x token addresses.

## Output

Returns the native coin balance and a list of ERC-20 token balances for the given address, each with raw (wei-level) and human-readable amounts. On Base, USD values can optionally be included. Response includes per-token contract addresses, symbols, decimals, and formatted amounts.

## 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": {
      "usd": {
       "type": "boolean",
       "description": "Add best-effort USD values (Base only)"
      },
      "tokens": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Base: token symbols or 0x addresses (default common set, max 25). Other networks: explicit 0x addresses only"
      },
      "address": {
       "type": "string",
       "description": "Wallet address (0x..)"
      },
      "network": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "bnb"
       ],
       "type": "string",
       "description": "EVM network to read from (default base)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstools-wallet-balances-4df0465a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)