# DexL Agents Wallet Balance

> DexL Agents Wallet Balance is a paid API for AI agents from agents.dexl.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns the native coin or ERC-20 token balance for any wallet address on 28 EVM-compatible chains, including the raw and decimal amounts and the block number at which the balance was read.

## Facts

- Endpoint: POST https://agents.dexl.io/v1/tools/wallet-balance
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dexl-agents-wallet-balance-4d6ef396
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fKpUj-AAvv1XHMQjcXAMk

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 dexl-agents-wallet-balance-4d6ef396 -d '<json body>'
```

Example prompt: What's the USDC balance on Base for wallet 0xAbC1234567890abcdef1234567890abcdef123456? Use the ERC-20 contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

## When to prefer this

Choose this endpoint when you need a quick, reliable on-chain balance read across any of 28 EVM chains without running your own RPC node. It is ideal for agents that need to verify funds before executing transactions, audit multi-chain portfolios, or gate actions on token holdings. Its broad chain coverage (Base, Ethereum, Arbitrum, Optimism, zkSync, Polygon, BSC, Avalanche, and 20 more) makes it preferable over single-chain alternatives when cross-chain flexibility is required.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain enum value returns a validation error
- Invalid ERC-20 contract address returns an error or zero balance
- Network congestion on target chain may cause timeout
- Missing required 'address' field returns a 400-level error

## How this service works

Read any wallet balance on 28 EVM chains: native coin (ETH, BNB, MATIC, AVAX) or any ERC-20 token including USDC. Covers Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, zkSync, Linea, Scroll, Blast, Mantle, Celo, Gnosis, Sonic, Unichain, World Chain, Zora and more. Returns the raw and decimal balance with the block it was read at.

## Output

A JSON object containing the raw balance (in the token's smallest unit), the decimal-formatted balance, the block number at which the read occurred, and a flag indicating whether the result was served from cache.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "abstract",
    "arbitrum",
    "avalanche",
    "base",
    "berachain",
    "blast",
    "bsc",
    "celo",
    "cronos",
    "ethereum",
    "fraxtal",
    "gnosis",
    "ink",
    "linea",
    "mantle",
    "metis",
    "mode",
    "opbnb",
    "optimism",
    "polygon",
    "robinhood",
    "scroll",
    "soneium",
    "sonic",
    "unichain",
    "worldchain",
    "zksync",
    "zora"
   ],
   "type": "string",
   "default": "base",
   "description": "Which chain to read from"
  },
  "token": {
   "type": "string",
   "description": "ERC-20 contract address. Omit for the native coin."
  },
  "address": {
   "type": "string",
   "description": "Wallet address (0x...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "units": 1,
  "cached": false,
  "output": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dexl-agents-wallet-balance-4d6ef396/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.dexl.io](https://www.zero.xyz/host/agents.dexl.io/llms.txt)