# LogicNodes EVM Balance

> LogicNodes EVM Balance is a paid API for AI agents from logicnodes.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns native and ERC-20 token balances for a given address on any EVM chain at a specified block

## Facts

- Endpoint: POST https://logicnodes.io/paid/v1/tools/evm_balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/logicnodes-evm-balance-c850b1a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6DM1hcxGK1cMOCyDxf0eP

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 logicnodes-evm-balance-c850b1a1 -d '<json body>'
```

Example prompt: Check the ETH and USDC balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base (eip155:8453) at the latest finalized block.

## When to prefer this

Choose this endpoint when you need a deterministic, block-consistent balance for one or more assets on any supported EVM chain. Ideal for agents that need exact on-chain data without hallucination risk, need multi-asset balances in a single call, or need a historical snapshot at a specific block. Prefer over generic RPC calls when you want a structured, agent-friendly JSON response with built-in payment via USDC x402.

## Known failure modes

- Invalid or non-checksum address returns an error (EIP-55 checksum enforced for mixed-case input)
- Chain name strings (e.g. 'ethereum') are refused — must use CAIP-2 or bare numeric chain ID
- More than 20 assets in a single request exceeds maxItems limit
- Unknown or unsupported chain ID returns an error
- Invalid block tag (anything other than 'latest', 'safe', 'finalized', or a decimal number) is rejected
- Payment failure via x402 protocol results in 402 response before query is processed

## How this service works

Exact answers for AI agents: 40+ tools for EVM chains and Aptos, gas on 14 chains, never a guess. Free tier; pay per call in USDC (x402) on 13 networks.

## Output

A JSON object with ok: true and the tool name, plus balance data for each requested asset (native and/or token contract addresses) at the requested block. Each balance is read consistently at the same block, ensuring a coherent snapshot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "block": {
   "type": "string",
   "description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
  },
  "chain": {
   "type": "string",
   "description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
  },
  "assets": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20,
   "minItems": 1,
   "description": "\"native\" and/or token contract addresses; default [\"native\"]"
  },
  "address": {
   "type": "string",
   "description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "evm_balance"
 }
}
```

## More

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