{"uid":"cap_rie_-6GfjgTG-3twktsCc","slug":"erc-20-transfer-history-91492ad8","name":"ERC-20 Transfer History","description":"Recent Transfer events of an ERC-20 token (newest first, up to 50): tx, time, from, to, amount in token units. Optional holder filters to transfers from or to one wallet. Reads up to the last 12000 blocks (fewer on very busy tokens) via RPC, so it is cheap but not a full history; the response says what range was searched. Use for quick wallet or token activity checks.","url":"https://agentsvc.io/api/v1/proxy/erc20-transfers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"base (default), ethereum, bsc, arbitrum, polygon, avalanche or optimism"},"limit":{"type":"number","default":20,"description":"1 to 50"},"token":{"type":"string","description":"Token contract address (0x...)"},"holder":{"type":"string","description":"Optional wallet address to filter by"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tC4Z-EchKeD50HaH2dw7x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the most recent ERC-20 token Transfer events (up to 50) for a given contract, optionally filtered to a specific wallet address, across multiple chains.","exampleAgentPrompt":"Pull the last 30 transfer events for the USDC contract on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) and filter them to my wallet 0xAbC123... so I can see recent inflows and outflows.","exampleUseCases":[{"title":"Token whale movement monitoring","prompt":"Show me the 50 most recent transfers for the ARB token on Arbitrum (0x912CE59144191C1204E64559FE8253a0e49E6548) — I want to see if any large wallets have been moving tokens around lately."},{"title":"Wallet activity check for a specific token","prompt":"Can you pull the recent USDC transfer history on Ethereum for my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Just the last 20 transactions, showing who sent and received how much."},{"title":"New token due diligence","prompt":"I'm looking at this new token on Base with contract 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — can you fetch the last 50 transfers so I can see if there's any real trading activity or if it's mostly the same wallets shuffling tokens around?"}],"resultDescription":"A JSON object with a success flag and a data payload containing an array of up to 50 transfer events (newest first), each with transaction hash, timestamp, from address, to address, and amount in token units, plus metadata indicating the block range that was searched.","failureModes":["Invalid or non-ERC-20 contract address returns empty results or error","Unsupported chain name causes a validation error","Very high-activity tokens may have a narrower block range searched than 12000 blocks","Limit outside 1–50 range may be rejected or clamped","RPC node unavailability on the requested chain causes a timeout or failure","Token with no recent transfers returns an empty array"],"whenToPreferThis":"Use this endpoint when you need a quick, cheap snapshot of recent ERC-20 transfer activity without requiring a full historical archive — ideal for wallet activity checks, due diligence on new tokens, or detecting recent on-chain movements. Prefer this over full indexing solutions when recency (last ~12000 blocks) is sufficient and cost efficiency matters. It supports multiple chains (Base, Ethereum, BSC, Arbitrum, Polygon, Avalanche, Optimism) in a single unified API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:35:02.254Z","isFirstParty":false,"canonicalSlug":"erc-20-transfer-history-91492ad8"}