# 1gateway EVM Wallet Balance Checker

> 1gateway EVM Wallet Balance Checker is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-11).

Fetches native and ERC-20 token balances for an EVM wallet address in a single call across Base, Ethereum, Arbitrum, or Monad

## Facts

- Endpoint: GET https://1gateway.dev/v1/onchain/balances?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/1gateway-evm-wallet-balance-checker-2a36f509
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ts0kjbkBLEG8toVIcWsEo

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 1gateway-evm-wallet-balance-checker-2a36f509
```

Example prompt: Can you pull all the token balances for 0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 on Base — native ETH plus the main stablecoins and WETH?

## When to prefer this

Use this endpoint when you need a complete, single-call snapshot of both native and ERC-20 token balances for an EVM address without price data. Ideal for pre-flight checks before transfers, portfolio audits, or treasury monitoring. Supports Base (default), Ethereum, Arbitrum, and Monad. Prefer over multi-call or block explorer scraping when you need raw+decimal balances, nonce, and contract detection in one response.

## Known failure modes

- 400 Bad Request if address is malformed or not a valid EIP-55 checksum (not charged)
- 400 if more than 20 token addresses are supplied
- Token entry has status 'not_an_erc20' if a supplied contract address is not an ERC-20
- Network or RPC timeout if the target chain is congested
- Unsupported chain value returns 400

## How this service works

Use when an agent needs an EVM wallet's holdings in one call. Input: address; chain (base default, ethereum, arbitrum, monad); optional tokens (up to 20 ERC-20s; default: main stablecoins, WETH, BTC wrappers). Output: JSON block+time, native balance (ETH; MON on Monad), per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1

## Output

Returns a JSON object containing the queried chain name and chainId, block number and timestamp, whether the address is a contract, code size, transaction count (nonce), native balance in both wei and decimal (ETH or MON on Monad), and an array of token objects each with symbol, decimals, raw balance, decimal balance, issuer, and status fields. Also includes the RPC source metadata and any notes.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "monad"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "tokens": {
       "type": "string",
       "maxLength": 900,
       "description": "Up to 20 comma-separated ERC-20 contract addresses on the chosen chain. Omit for the default set. A…"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet or contract (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not …"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "chain",
      "chainId",
      "address",
      "block",
      "isContract",
      "codeSize",
      "transactionCount",
      "eth",
      "native",
      "tokenSet"
     ],
     "properties": {
      "eth": {
       "type": "object",
       "properties": {
        "wei": {
         "type": "string"
        },
        "balance": {
         "type": "number"
        }
       },
       "additionalProperties": true
      },
      "block": {
       "type": "object",
       "properties": {
        "number": {
         "type": "integer"
        },
        "timestamp": {
         "type": "string"
        }
       },
       "additionalProperties": true
      },
      "chain": {
       "type": "string"
      },
      "native": {
       "type": "object",
       "properties": {
        "wei": {
         "type": "string"
        },
        "symbol": {
         "type": "string"
        },
        "balance": {
         "type": "number"
        }
       },
       "additionalProperties": true
      },
      "address": {
       "type": "string"
      },
      "chainId": {
       "type": "integer"
      },
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-evm-wallet-balance-checker-2a36f509/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)
