zkSync Era ERC-20 balance
ERC-20 token balance of a wallet on zkSync Era (USDC, USDT, WETH or any token, via balanceOf): raw amount, decimals, symbol and the human-readable amount, live from the token contract. Use to check stablecoin or token holdings before a transfer or trade; for the native coin use zksync_balance. Both inputs are 0x addresses (40 hex characters); no contract returns 404 and a non-ERC-20 contract 422, both uncharged.
Inputs
| Name | Type | Description |
|---|---|---|
token (required) | string | Token: a ticker such as USDC, USDT, WETH or DAI, or the 0x ERC-20 contract address |
address (required) | string | 0x wallet address |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/zksync/token-balance?token=0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/zksync/token-balance?token=0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.
Example result
{
"chain": "zkSync Era",
"chainId": 324,
"token": "0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4",
"symbol": "USDC",
"decimals": 6,
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"raw": "2500000",
"balance": "2.5"
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is zksync_token_balance, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp