---
title: "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."
method: POST
path: "/v1/tools/wallet-balance"
---

# 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.

`POST /v1/tools/wallet-balance`

## Request

- Base URL: `https://agents.dexl.io`
- URL: `https://agents.dexl.io/v1/tools/wallet-balance`
- Auth: API key in header `X-Payment`

Paid per call via x402. Send without payment to get the exact price in the 402.

## Request body

- object
  - `chain` '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': Which chain to read from
  - `address` string, required: Wallet address (0x...)
  - `token` string: ERC-20 contract address. Omit for the native coin.

## Response `200`

The tool output

## Other responses

- `400`: The input did not match the schema
- `402`: Payment required

---

[API](https://skmtc.dev/dexl/apis/dexl-agents.md) · [All operations](https://skmtc.dev/dexl/apis/dexl-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/dexl/apis/dexl-agents/revisions/e3692765c3f7?raw)