# ETH Balance Lookup by Address

> ETH Balance Lookup by Address is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns the ETH balance of a given wallet or contract address on Ethereum, including both human-readable and raw Wei amounts.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/eth/balance?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eth-balance-lookup-by-address-920f6313
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FpK34J13735evkQiE_iBT

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 eth-balance-lookup-by-address-920f6313
```

Example prompt: What's the current ETH balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

## When to prefer this

Use this endpoint when you need a quick, no-account, pay-per-call ETH balance check on Ethereum mainnet for any wallet or contract address. It is ideal for AI agents that need on-chain balance data without managing API keys, and when cost predictability at $0.001 per call matters. Prefer alternatives if you need balances across multiple chains simultaneously or ERC-20 token balances rather than native ETH.

## Known failure modes

- Invalid or malformed 0x address returns an error response
- Address with zero balance returns balance='0' and balanceWei='0' (not an error)
- Network timeouts or RPC node failures may cause transient errors
- No charge is applied for failed calls per x402 protocol

## How this service works

Native ETH balance (eth_getBalance) of any 0x wallet address on Ethereum at the latest block, in wei and in ETH. Use to check whether a wallet can pay gas or a transfer; for ERC-20 tokens use eth_token_balance, for all holdings at once use wallet_portfolio. A malformed address is rejected with 400, uncharged.

## Output

Returns a JSON object with the ETH balance as a human-readable decimal string, the raw balance in Wei, the block number at which the balance was read, the chain name (e.g. 'Ethereum'), the chainId (e.g. 1), the queried address, and the symbol ('ETH').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "description": "0x wallet or contract address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "block": {
   "type": "number"
  },
  "chain": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "address": {
   "type": "string"
  },
  "balance": {
   "type": "string"
  },
  "chainId": {
   "type": "number"
  },
  "balanceWei": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eth-balance-lookup-by-address-920f6313/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)