# OpenRelay Wallet Balance

> OpenRelay Wallet Balance is a paid API for AI agents from openrelay.hggfffdfy687.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the USDC or native token balance for a given wallet address on Base or Solana.

## Facts

- Endpoint: POST https://openrelay.hggfffdfy687.workers.dev/tools/wallet/balance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openrelay-wallet-balance-2743dd56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zessOAD26lyxvWPXbJcCy

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 openrelay-wallet-balance-2743dd56 -d '<json body>'
```

Example prompt: What's the USDC balance on Base for the wallet address 0x1234abcd...? I need to know if there are enough funds before we proceed.

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call balance lookup for a specific wallet on Base or Solana without managing your own RPC infrastructure. It is ideal for AI agents that need to verify wallet balances before executing payments, for lightweight treasury monitoring, or when integrating balance checks into automated workflows that require USDC or native token data on these two chains specifically.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Unsupported chain value (not 'base' or 'solana') returns a validation error
- Unknown or undeployed ERC20 contract address returns zero or error
- Network congestion or RPC node unavailability may cause timeout
- Missing required fields (chain or address) returns a 400-level error

## How this service works

Read USDC or native token balance for an address on Base or Solana. Body: {chain, address, token?}.

## Output

A JSON object containing the balance of the requested token (USDC, ETH, SOL, NATIVE, or a specific ERC20/SPL token) for the given wallet address on the specified chain (Base or Solana), expressed as a numeric value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "solana"
   ],
   "type": "string"
  },
  "token": {
   "type": "string",
   "default": "USDC",
   "description": "USDC | ETH | SOL | NATIVE | ERC20 contract address / SPL mint"
  },
  "address": {
   "type": "string",
   "description": "Wallet address (0x… on Base, base58 on Solana)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openrelay-wallet-balance-2743dd56/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from openrelay.hggfffdfy687.workers.dev](https://www.zero.xyz/host/openrelay.hggfffdfy687.workers.dev/llms.txt)