# santyvv-data Native Balance

> santyvv-data Native Balance is a paid API for AI agents from santyvv-x402.santyvv1993.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns the native cryptocurrency balance (e.g. ETH, MATIC) of a given blockchain address

## Facts

- Endpoint: GET https://santyvv-x402.santyvv1993.workers.dev/api/chain/balance?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/santyvv-data-native-balance-65078e62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FdRwl1HOMcLJvP2VYEVsy

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 santyvv-data-native-balance-65078e62
```

Example prompt: What's the current native ETH balance of wallet address 0x742d35Cc6634C0532925a3b8D4C9C0B1c2e3f4a5?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call lookup of a native token balance (ETH, MATIC, etc.) for any given address without running your own node or indexer. It is ideal for lightweight agents that occasionally need balance checks without managing blockchain infrastructure. Prefer this over ERC-20 balance endpoints when you want the chain's native currency, not a token contract balance.

## Known failure modes

- Invalid or malformed address returns an error response
- Unsupported chain identifier results in a 400 or 404 error
- Network congestion or node unavailability may cause timeouts
- Payment failure ($0.01 USDC) will block access to the endpoint
- Empty or zero balance returned for unfunded addresses — not an error, but may be misinterpreted

## How this service works

Native balance of an address

## Output

Returns the native cryptocurrency balance (in wei or the chain's base unit) for the queried address, reflecting its current on-chain state.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/santyvv-data-native-balance-65078e62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from santyvv-x402.santyvv1993.workers.dev](https://www.zero.xyz/host/santyvv-x402.santyvv1993.workers.dev/llms.txt)