# Financial Data x402 – Wallet Balance Lookup

> Financial Data x402 – Wallet Balance Lookup is a paid API for AI agents from x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns the current native token balance for a given on-chain wallet address, including balance in both decimal and wei units, chain, and timestamp.

## Facts

- Endpoint: GET https://x402financialdata.com/wallet-balance/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-wallet-balance-lookup-d3db2b56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h5r-T9E18Vo0fI8kLIgSZ

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 financial-data-x402-wallet-balance-lookup-d3db2b56
```

Example prompt: What's the current ETH balance for wallet address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae on Ethereum?

## When to prefer this

Choose this endpoint when you need a pay-per-call, no-subscription way to fetch the current native token balance (e.g. ETH) of any on-chain wallet address. It is ideal for agents that need sporadic or one-off balance checks without committing to an API key or monthly plan, and when micropayment via USDC on Base or Solana is acceptable. Prefer alternatives if you need ERC-20 token balances, historical balance data, or multi-chain batch lookups in a single call.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty response
- Unsupported chain identifier may return no data
- Payment failure via x402 (insufficient USDC balance or failed micropayment) blocks the request
- Rate limiting or network congestion may cause timeouts
- Address with zero balance may return balance of 0 rather than an error

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

Returns a JSON object with the wallet address, chain identifier, timestamp of the balance snapshot, native token balance as a decimal float, balance expressed in wei (smallest unit), and the native token symbol (e.g. ETH). Example: {as_of, chain, address, balance, balance_wei, native_symbol}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-07-31T03:43:30.000000",
  "chain": "eth",
  "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
  "balance": 1.28453901,
  "balance_wei": "1284539010000000000",
  "native_symbol": "ETH"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-wallet-balance-lookup-d3db2b56/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402financialdata.com](https://www.zero.xyz/host/x402financialdata.com/llms.txt)