{"uid":"cap_oSeXKLzwxDQ7znhcf3433","slug":"erc-20-transfers-7f88020b","name":"ERC-20 Transfers","description":"Recent ERC-20 Transfer events for a token, a wallet (in and out) or both over the last N blocks (max 5,000), with sender, receiver and amount in token units. Use to confirm incoming payments or watch whale moves.","url":"https://bess-x402.onrender.com/v1/evm/erc20-transfers?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"chain":{"type":"string","description":"ethereum, base, arbitrum, optimism or polygon"},"limit":{"type":"integer","description":"Maximum number of results (1-500)"},"token":{"type":"string","description":"Token address or USDC/USDT/DAI"},"blocks":{"type":"integer","description":"How many recent blocks (1-5000)"},"wallet":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EhBFJ3aJllpSHWYbp2A45","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent ERC-20 Transfer events for a token address, wallet address, or both over the last N blocks (up to 5,000) with sender, receiver, and amount.","exampleAgentPrompt":"Can you pull the last 500 USDC transfers involving my wallet 0xAbC...123 on Base over the past 2000 blocks so I can confirm a payment I'm expecting came through?","exampleUseCases":[{"title":"Confirm incoming token payment","prompt":"Check if any USDT has been sent to my wallet 0xDe...456 on Ethereum in the last 1000 blocks — I'm waiting for a payment and want to confirm it arrived."},{"title":"Track whale moves on a token","prompt":"Show me the 500 most recent transfers of token 0xA0b86...eB48 on Ethereum over the last 5000 blocks so I can see if any large wallets are moving big amounts."},{"title":"Audit outgoing transfers from a treasury","prompt":"Get all ERC-20 transfers sent from our treasury wallet 0xF00...Bar on Arbitrum in the last 3000 blocks — I need to audit what went out recently."}],"resultDescription":"A list of ERC-20 Transfer events, each containing the sender address, receiver address, token amount in token units, token contract address, transaction hash, block number, and timestamp, filtered by the specified wallet, token, chain, and block range.","failureModes":["Invalid or non-checksummed wallet/token address returns an error","Unsupported chain name returns validation error","blocks parameter exceeding 5000 is rejected","limit out of 1-500 range is rejected","No transfers found returns an empty list","RPC node timeout for very large block ranges"],"whenToPreferThis":"Use this endpoint when you need to retrieve historical ERC-20 transfer events for a specific wallet or token on EVM-compatible chains (Ethereum, Base, Arbitrum, Optimism, Polygon) within a recent block window. It is ideal for payment confirmation, whale watching, and treasury auditing. Prefer this over on-chain indexers when you need a lightweight, pay-per-call lookup without managing your own infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:49:23.212Z","isFirstParty":false,"canonicalSlug":"erc-20-transfers-7f88020b"}