# Polygon PoS Wallet Balance Checker

> Polygon PoS Wallet Balance Checker 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 POL balance and up to 20 ERC-20 token balances for a given Polygon PoS wallet address, with symbols and decimals applied.

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/polygon/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/polygon-pos-wallet-balance-checker-0ae9e15e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nT2jz1VtxeDkXF-_gg0uO

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 polygon-pos-wallet-balance-checker-0ae9e15e
```

Example prompt: What's the native POL balance and the USDC and WETH token balances for the Polygon PoS wallet 0xAbCd1234...5678? The USDC contract is 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 and WETH is 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619.

## When to prefer this

Use this endpoint when you need live, on-chain POL and ERC-20 token balances for a specific Polygon PoS wallet, especially when you need multiple token balances in a single call with symbols and decimals already resolved. Prefer this over general blockchain explorers when you need structured, programmatically usable data rather than a UI, and when you specifically want Polygon PoS (not Ethereum mainnet, Arbitrum, Base, or Solana).

## Known failure modes

- Invalid wallet address format returns a 400 or error response
- Invalid ERC-20 contract address in the tokens list causes a failure or partial result
- Exceeding 20 token addresses in the comma-separated list returns an error
- Network congestion or RPC node issues may cause timeouts
- Non-existent or zero-balance tokens return 0 rather than an error
- Payment failure via x402 protocol blocks the request

## 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 POL balance formatted with 18 decimal places, plus an array of ERC-20 token balances each annotated with the token symbol and decimals for human-readable interpretation — all read live from Polygon PoS at query time.

## 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 Polygon PoS, up to 20"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address on Polygon PoS"
      }
     },
     "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": "polygon",
  "tokens": [
   {
    "raw": "9885164",
    "token": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "symbol": "USDC",
    "balance": "9.885164",
    "decimals": 6
   },
   {
    "raw": "2622273351494",
    "token": "0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39",
    "symbol": "LINK",
    "balance": "0.000002622273351494",
    "decimals": 18
   }
  ],
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "nativeSymbol": "POL",
  "nativeBalance": "592.719767156691654977"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polygon-pos-wallet-balance-checker-0ae9e15e/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)