{"uid":"cap_IIKOwFg_H8ImF3zCBkW7s","slug":"synapse-api-polygon-token-transfer-history-cf674009","name":"Synapse API — Polygon Token Transfer History","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/transfers","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"order":{"enum":["asc","desc"],"type":"string"},"owner":{"type":"string"},"pageKey":{"type":"string"},"toBlock":{"type":"string"},"maxCount":{"type":"number"},"fromBlock":{"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_r3d3aaV4Q-PNA4zhPgj2W","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 historical ERC-20 and native token transfer events for a given address or contract on the Polygon network","exampleAgentPrompt":"Pull all ERC-20 token transfers for the Polygon wallet 0xABC...123 from block 50000000 to 51000000, sorted in descending order, and show me the first 100 results.","exampleUseCases":[{"title":"Audit wallet token activity","prompt":"Show me every token transfer in and out of the Polygon wallet 0xDEF...456 between block 48000000 and 49000000, sorted oldest to newest, up to 200 results."},{"title":"Track specific token contract movements","prompt":"Find all transfers for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 involving the wallet 0xABC...789 on Polygon, sorted in descending order."},{"title":"Paginate large transfer history","prompt":"I already fetched the first page of token transfers for 0x111...222 on Polygon — here's my pageKey from the last response, can you fetch the next 50 records in descending order?"}],"resultDescription":"Returns a list of token transfer events on the Polygon network, each including transaction hash, block number, from/to addresses, token contract address, amount, and asset type. Supports cursor-based pagination via pageKey for large result sets.","failureModes":["Invalid or malformed wallet address returns an error or empty result set","Unrecognized contract address yields no results without explicit error","Invalid block range (fromBlock > toBlock) may return an error or empty array","Exceeding max allowed maxCount may be capped or return an error","Exhausted pageKey (stale or invalid) returns an error or empty page","Network or upstream indexer downtime returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need historical token transfer data specifically on the Polygon network and want to filter by owner wallet, contract address, or block range. Prefer it over generic blockchain explorers when you need machine-readable, paginated JSON output suitable for programmatic processing. It is especially useful for auditing wallet activity, building transfer timelines, or feeding DeFi analytics pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:51:20.957Z","isFirstParty":false}