{"uid":"cap_cdF8NBGdMbC10keTbJfp8","slug":"synapse-api-polygon-token-balances-e9596486","name":"Synapse API — Polygon Token Balances","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/polygon/token/balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string"},"contractAddresses":{"type":"array","items":{"type":"string"}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a0DuQHaAi8EqGOkxWzT9N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves ERC-20 token balances for a given wallet address on the Polygon network, optionally filtered by specific contract addresses","exampleAgentPrompt":"What are all the ERC-20 token balances for wallet 0xAbC1234...5678 on Polygon? Also check the balance for USDC contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 specifically.","exampleUseCases":[{"title":"DeFi portfolio tracker check","prompt":"Show me all the token balances held by wallet 0x742d35Cc6634C0532925a3b8D4C9B1234567890 on Polygon so I can see the full portfolio."},{"title":"Verify token receipt on Polygon","prompt":"Did the USDC transfer arrive? Check the USDC token balance (contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) for wallet 0xRecipient123 on Polygon."},{"title":"Multi-token audit for a wallet","prompt":"I need to audit this wallet's holdings on Polygon — pull balances for these three token contracts: 0xTokenA, 0xTokenB, and 0xTokenC for address 0xAuditWallet456."}],"resultDescription":"Returns a list of ERC-20 token balances associated with the given wallet address on the Polygon network, including token contract addresses, token symbols, decimals, and balance amounts. If specific contract addresses are provided, results are filtered to those tokens only.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Non-existent or invalid contract address may return zero balance or error","Rate limiting or payment failure (x402) returns 402 Payment Required","Polygon RPC node downtime may cause timeouts or 503 errors","Address with no token holdings returns an empty balances array"],"whenToPreferThis":"Choose this endpoint when you need to look up ERC-20 token balances specifically on the Polygon (MATIC) network. It is ideal for DeFi portfolio tracking, verifying token transfers, auditing wallet holdings, or checking specific contract balances on Polygon. Prefer this over Ethereum mainnet equivalents when the target chain is Polygon, and over general multi-chain solutions when you only need Polygon data at low per-call cost ($0.01 USDC).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:45:08.769Z","isFirstParty":false,"canonicalSlug":"synapse-api-polygon-token-balances-e9596486"}