# Cortex402 Wallet Balance Validator

> Cortex402 Wallet Balance Validator is a paid API for AI agents from jtifhcvbgxqwlywugvjv.supabase.co, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Queries on-chain native or ERC-20 token balance for a given EVM wallet address and network, returning balance, block height, and an optional sufficient/deficient flag against a threshold.

## Facts

- Endpoint: POST https://jtifhcvbgxqwlywugvjv.supabase.co/functions/v1/cortex402-wallet-balance
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jtifhcvbgxqwlywugvjv-supabase-co-8d4fbc66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w67fdM9WCE77U5X8BL5dz

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 jtifhcvbgxqwlywugvjv-supabase-co-8d4fbc66 -d '<json body>'
```

Example prompt: Can you check whether the wallet 0xAbC123...def on Base mainnet has at least 50 USDC — I need to know if it's sufficiently funded before I proceed?

## When to prefer this

Choose this endpoint when you need a fast, single-call on-chain balance lookup across Base, Ethereum, Arbitrum, Optimism, or Polygon — especially when you also need to validate sufficiency against a threshold before triggering a payment or workflow step. Preferred over block explorer scraping or full node queries when you want a normalized, structured response with a built-in sufficient/deficient flag.

## Known failure modes

- Invalid or malformed wallet address returns a 4xx error with address validation message
- Unsupported network enum value returns an error listing valid chains
- Unknown or unsupported token symbol returns an error; use raw ERC-20 contract address as fallback
- RPC node timeout or chain congestion may cause delayed or failed responses
- Threshold provided in wrong format (e.g. mixing decimal and atomic units) may yield incorrect sufficient/deficient flag
- Payment of $0.02 USDC not provided or rejected results in 402 Payment Required

## How this service works

Check any wallet balance across 5 EVM chains. Returns native or ERC-20 balance with threshold check, block height, and on-chain receipt. Supports Base, Ethereum, Arbitrum, Optimism, and Polygon.

## Output

Returns the current on-chain balance (in decimal and raw atomic units), the block height at the time of query, and — if a threshold was provided — a sufficient/deficient flag indicating whether the wallet meets the required balance.

## Example request

```json
{
 "token": "USDC",
 "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f42bE1",
 "network": "base",
 "threshold": "100"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "description": "Token symbol (USDC/USDT/WETH/WBTC/DAI) or raw ERC-20 contract address. Omit for native balance."
  },
  "address": {
   "type": "string",
   "description": "EVM wallet address (0x-prefixed 40-hex)"
  },
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string",
   "description": "Chain to query. Defaults to Base mainnet."
  },
  "threshold": {
   "type": "string",
   "description": "Optional decimal amount or raw atomic units. If provided, response includes sufficient/deficient flag."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jtifhcvbgxqwlywugvjv-supabase-co-8d4fbc66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jtifhcvbgxqwlywugvjv.supabase.co](https://www.zero.xyz/host/jtifhcvbgxqwlywugvjv.supabase.co/llms.txt)