{"uid":"cap_nT2jz1VtxeDkXF-_gg0uO","slug":"polygon-pos-wallet-balance-checker-0ae9e15e","name":"Polygon PoS Wallet Balance Checker","description":"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.","url":"https://ca-tax-api-mainnet.lxtap.workers.dev/polygon/balances?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SpxaDIzEXwnyUOczG8j17","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you pull the current POL balance plus the USDT and MATIC bridged token balances for my Polygon wallet 0xDEAD...BEEF? USDT is at 0xc2132D05D31c914a87C6611C10748AEb04B58e8F."},{"title":"Pre-transfer balance verification","prompt":"Before I send funds, check the live POL balance and the USDC balance on Polygon PoS for address 0x1234...ABCD — USDC contract is 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174."},{"title":"Multi-token audit for a smart contract treasury","prompt":"I need to audit this treasury address on Polygon PoS: 0xAAAA...1111. Fetch its native POL and the balances for these five ERC-20s: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174, 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619, 0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270, 0xD6DF932A45C0f255f85145f286eA0b292B21C90B, 0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:45:07.843Z","isFirstParty":false,"canonicalSlug":"polygon-pos-wallet-balance-checker-0ae9e15e"}