# Gnosis Chain Native xDAI Balance Lookup

> Gnosis Chain Native xDAI Balance Lookup is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-17).

Returns the native xDAI balance (in wei, as a hex string) of a single Ethereum-style address on Gnosis Chain at the latest block.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/gnosis_eth_getbalance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gnosis-chain-native-xdai-balance-lookup-32411428
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y1yJOcGdT9tnbF_E9LM8d

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 gnosis-chain-native-xdai-balance-lookup-32411428
```

Example prompt: What is the current xDAI balance of 0x4fC2E4Cb2FB7b5B2b6C3e2D7e1A0B3C5D6E7F890 on Gnosis Chain?

## When to prefer this

Use this endpoint when you specifically need the native xDAI balance on Gnosis Chain (not Ethereum mainnet, Base, or another EVM chain). Prefer it over generic RPC calls when you want a simple, pay-per-call REST interface without managing your own JSON-RPC node. Best for single-address spot checks; use bundle endpoints if you also need network info in the same call.

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns a 400 error
- Payment failure (insufficient USDC or missing x402 header) returns a 402 error
- Address with zero balance returns hex '0x0' and result 0 (not an error)
- Network unavailability of Gnosis Chain RPC returns a 5xx error
- Malformed request missing the address query parameter returns a 4xx error

## How this service works

ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.

## Output

Returns a JSON object with ok (boolean), hex (balance in hexadecimal wei), chain (identifier string 'gnosis'), method ('eth_getBalance'), result (numeric balance in wei), and service name.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "hex": "0x78de861da3c39a15",
  "chain": "gnosis",
  "method": "eth_getBalance",
  "result": 8709546191240797000,
  "service": "x402_chain_reads_v1.gnosis_eth_getbalance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gnosis-chain-native-xdai-balance-lookup-32411428/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arysphere.com](https://www.zero.xyz/host/api.arysphere.com/llms.txt)