# NodeFlare Multi-Chain Token Balance API

> NodeFlare Multi-Chain Token Balance API is a paid API for AI agents from rpc.nodeflare.app, paid per call via x402, $0.0051/call, status unknown (last checked 2026-09-14).

Returns native and ERC-20 token balances for a single wallet address across up to 23 EVM chains in one request, paid per call in USDC with no API key required.

## Facts

- Endpoint: POST https://rpc.nodeflare.app/data/balances/x402
- Price: $0.0051/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nodeflare-multi-chain-token-balance-api-fd14253c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sirp9rYhv4-Wve0hJov0k

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 nodeflare-multi-chain-token-balance-api-fd14253c -d '<json body>'
```

Example prompt: What are all the token balances for wallet 0xAbC123...def on Ethereum, Base, Arbitrum, Optimism, and BNB Chain — include both native tokens and any ERC-20s?

## When to prefer this

Choose this endpoint when you need to aggregate native and ERC-20 balances for a single wallet across many EVM chains simultaneously without managing multiple RPC calls or API keys. It is especially valuable when you need coverage of newer or niche EVM chains (Robinhood Chain, Plasma, Ink) that major providers like Alchemy or Moralis do not support. Ideal for agents that need to pay per use in USDC with no account setup.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain identifier in the chains array causes a rejection
- Insufficient USDC payment results in a 402 payment required error
- Network timeout or node unavailability for a specific chain may return partial results
- Empty token list returned if wallet has no holdings on a requested chain

## How this service works

Multi-chain balances API: native + ERC-20 token balances for one address across up to 23 EVM chains (Ethereum, Base, Arbitrum, Optimism, BNB, and young chains like Robinhood, Plasma, Ink that Alchemy/Moralis omit) in a single request. Pay per call in USDC, no account or API key - built for AI agents. Priced about $0.0003 per chain.

## Output

A structured JSON response containing per-chain breakdowns of the wallet's native token balance and ERC-20 token balances, including token symbols, contract addresses, decimals, and amounts for each requested chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "tokens": {
   "type": "object"
  },
  "address": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nodeflare-multi-chain-token-balance-api-fd14253c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rpc.nodeflare.app](https://www.zero.xyz/host/rpc.nodeflare.app/llms.txt)