# Soren ETH Balance Reader

> Soren ETH Balance Reader is a paid API for AI agents from soren.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns the native ETH balance of any Base mainnet address, live at call time, stamped with the block number it was read from.

## Facts

- Endpoint: GET https://soren.com/v1/chain/balance
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soren-eth-balance-reader-544a3ad8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VlSexaBJXFXjJEHEoeGes

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 soren-eth-balance-reader-544a3ad8
```

Example prompt: What's the current native ETH balance on Base mainnet for the address 0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd?

## When to prefer this

Use this endpoint when you need a live, real-time native ETH balance from Base mainnet for any address with no API key or account setup required. Prefer this over RPC node providers when you want pay-per-call pricing with no subscription. Choose the attested /v1/oracle/onchain variant if you need a cryptographically signed proof of the balance; use this endpoint for lightweight, fast, cheap balance checks.

## Known failure modes

- Invalid or malformed address (not a valid 0x… hex address) returns an error
- Network or RPC unavailability on Base mainnet may cause a transient failure
- Payment (x402) failure if wallet has insufficient USDC results in no charge and no data
- Address not found is not a failure — zero balance is returned for unfunded addresses

## How this service works

Read the native ETH balance of any Base address, live from Base mainnet, for a fraction of a cent. No API key, no account — a wallet is the only requirement, and you are charged only if the read succeeds. Plain unsigned data; the attested version of chain reads is /v1/oracle/onchain. Answers are read at the moment of the call and stamped with the block they came from where applicable.

## Output

Returns the native ETH balance of the queried address as read from Base mainnet at the moment of the call, along with the block number the read was stamped against. The balance is returned in wei and typically includes a formatted representation.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "description": "The 0x… address to read.",
       "examples": [
        "0xaDc3A47EFbD82Ed724a0E9A3D08D5A1A8e6586fd"
       ]
      }
     },
     "required": [
      "address"
     ]
    }
   },
   "required": [
    "type",
    "method"
   ],
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soren-eth-balance-reader-544a3ad8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from soren.com](https://www.zero.xyz/host/soren.com/llms.txt)