# x402node Multichain Native & ERC20 Token Balance

> x402node Multichain Native & ERC20 Token Balance is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns the native coin balance (ETH, MATIC, etc.) or ERC20 token balance for any wallet address on Ethereum, Base, Arbitrum, Optimism, or Polygon

## Facts

- Endpoint: GET https://api.x402node.dev/chain/balance
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402node-multichain-native-erc20-token-balance-26cbf813
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AlrkpJq-HK1qjX97cmD5l

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 x402node-multichain-native-erc20-token-balance-26cbf813
```

Example prompt: What's the current ETH balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the Base network, and also check its USDC balance using token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Use this endpoint when you need on-chain balance data for a wallet across Ethereum, Base, Arbitrum, Optimism, or Polygon — either for native coins or any ERC20 token. Prefer this over general-purpose blockchain explorers when you need a simple, low-latency programmatic balance check without scraping an explorer UI.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain identifier returns an error
- Invalid ERC20 contract address returns an error or zero balance
- RPC node unavailable leads to timeout or 5xx error
- Rate limiting or payment failure returns 402 or 429

## How this service works

Native coin balance for any address on Ethereum, Base, Arbitrum, Optimism or Polygon, optionally an ERC20 token balance with symbol and decimals. wallet balance, eth balance, erc20 token balance, check address balance, multichain balance

## Output

Returns the native coin balance (e.g. ETH in wei and formatted) for the given address on the specified chain. If an ERC20 contract address is provided, returns the token balance along with the token symbol and decimals.

## Example request

```json
{
 "chain": "ethereum",
 "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
```

## 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": {
       "type": "string",
       "description": "ethereum, base (default), arbitrum, optimism, polygon"
      },
      "token": {
       "type": "string",
       "description": "Optional ERC20 contract address for token balance"
      },
      "address": {
       "type": "string",
       "description": "Wallet address (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402node-multichain-native-erc20-token-balance-26cbf813/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)