# OP Mainnet Wallet Balance Lookup

> OP Mainnet Wallet Balance Lookup is a paid API for AI agents from ca-tax-api-mainnet.lxtap.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Returns the native ETH balance and up to 20 ERC-20 token balances for a given OP Mainnet wallet address, formatted with each token's symbol and decimals.

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/optimism/balances?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/op-mainnet-wallet-balance-lookup-9d826080
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xuhDiHjJAf99zMT8Rncgn

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 op-mainnet-wallet-balance-lookup-9d826080
```

Example prompt: What's the current ETH balance and USDC balance (contract 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85) for the Optimism wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

## When to prefer this

Use this endpoint when you need live, formatted token balance data specifically for OP Mainnet (Optimism) wallets. It handles both native ETH and up to 20 ERC-20 tokens in a single call with decimal formatting already applied. Prefer this over Ethereum or Arbitrum siblings when the target address and tokens are on OP Mainnet specifically.

## Known failure modes

- Invalid wallet address format returns a validation error
- Invalid or non-existent ERC-20 contract address may return zero balance or an error
- More than 20 token addresses provided will fail schema validation
- Network or RPC issues on OP Mainnet may cause timeouts or partial results
- Payment failure (x402) if USDC balance is insufficient for the $0.005 per-call fee

## How this service works

Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.

## Output

A JSON object containing the wallet's native ETH balance and an array of ERC-20 token balances, each entry including the token contract address, symbol, human-readable balance adjusted for decimals, and raw balance. Data is read live from OP Mainnet.

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "tokens": {
       "type": "string",
       "pattern": "^(0x[0-9a-fA-F]{40})(,0x[0-9a-fA-F]{40}){0,19}$",
       "description": "Comma-separated ERC-20 contract addresses on OP Mainnet, up to 20"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address on OP Mainnet"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "optimism",
  "tokens": [
   {
    "raw": "24433911",
    "token": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "symbol": "USDC",
    "balance": "24.433911",
    "decimals": 6
   },
   {
    "raw": "1000000000000000000",
    "token": "0x4200000000000000000000000000000000000042",
    "symbol": "OP",
    "balance": "1",
    "decimals": 18
   }
  ],
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "nativeSymbol": "ETH",
  "nativeBalance": "0.181079591875347535"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/op-mainnet-wallet-balance-lookup-9d826080/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ca-tax-api-mainnet.lxtap.workers.dev](https://www.zero.xyz/host/ca-tax-api-mainnet.lxtap.workers.dev/llms.txt)