# 2s.io EVM Token Balance Lookup

> 2s.io EVM Token Balance Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-09-15).

Returns native coin and ERC-20 token balances for any EVM wallet address across Base, Ethereum, Polygon, Arbitrum, and Optimism in a single multicall

## Facts

- Endpoint: GET https://2s.io/api/crypto/balances
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-evm-token-balance-lookup-4cfcfb94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e05nSEf9EWhERCLEVHxAf

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 2s-io-evm-token-balance-lookup-4cfcfb94
```

Example prompt: Check the native ETH balance and the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum.

## When to prefer this

Use this endpoint when you need live, on-chain token and native coin balances for an EVM wallet without managing your own RPC connections or API keys. Ideal for wallet dashboards, agent payment flows that need to verify funds before transacting, treasury monitoring, and settlement checks. Prefer this over general blockchain explorers when you need structured, machine-readable balance data with decimals already resolved in a single low-latency call across multiple EVM chains.

## Known failure modes

- Invalid or malformed EVM address returns an error
- Unsupported chain value returns a validation error
- More than 20 ERC-20 contract addresses supplied exceeds the limit
- Invalid ERC-20 contract address in the tokens list may return zero or an error for that token
- Network or RPC timeout results in a 500 or timeout error
- Address with no transactions may return zero balances rather than an error

## How this service works

Live native + ERC-20 token balances for an EVM address (Base, Ethereum, Polygon, Arbitrum, Optimism; keyless). Returns the native-coin balance and, for any ERC-20 contract addresses you pass, the symbol, decimals, raw and human-formatted balance — fetched in one multicall. For wallet dashboards, treasury checks, and agent payment/settlement flows.

## Output

Returns the native coin balance for the given address plus, for each ERC-20 contract address supplied, the token symbol, decimals, raw balance (as a big integer string), and human-formatted balance (adjusted for decimals) — all fetched in a single multicall from the specified EVM chain.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "optimism"
       ],
       "type": "string",
       "description": "Default base."
      },
      "tokens": {
       "type": "string",
       "maxLength": 900,
       "description": "Comma-separated ERC-20 contract addresses (max 20)."
      },
      "address": {
       "type": "string",
       "description": "EVM address to read."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-evm-token-balance-lookup-4cfcfb94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)