{"uid":"cap_DukB46mOe16F5FiViRacW","slug":"ethereum-erc-20-token-transfer-history-d12c9844","name":"Ethereum ERC-20 Token Transfer History","description":"List a wallet's recent transfers of one ERC-20 token (default USDC) on Ethereum, in and out, over the last N blocks (1-2,000, default 1,000): direction, counterparty, amount and transaction, newest first, up to 50. Use to confirm a payment arrived or see what was sent; for the current balance use eth_token_balance. Malformed addresses are rejected with 400, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/token-transfers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"token":{"type":"string","description":"Token: a ticker such as USDT or WETH, or the 0x ERC-20 contract (default: USDC on this network)"},"blocks":{"type":"integer","description":"How many recent blocks to scan (1-2000, default 1000; 2,000 blocks is about 6.7 hours on Ethereum)"},"address":{"type":"string","description":"0x wallet address"}}},"responseSchema":{"type":"object","properties":{"chain":{"type":"string"},"count":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"transfers":{"type":"array","items":{"type":"object","properties":{"tx":{"type":"string"},"raw":{"type":"string"},"block":{"type":"number"},"token":{"type":"string"},"amount":{"type":"string"},"symbol":{"type":"string"},"direction":{"type":"string"},"counterparty":{"type":"string"}}}},"truncated":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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_QTdB2_FH1GYaDgoFpe4ht","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":"Lists recent inbound and outbound ERC-20 token transfers for a wallet on Ethereum over a specified block range, newest first.","exampleAgentPrompt":"Show me the last 500 blocks of USDC transfers in and out of wallet 0xAbC123...def for Ethereum — I want to see direction, counterparty, and amount for each one.","exampleUseCases":[{"title":"Confirm incoming payment arrived","prompt":"Did wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e receive any USDC in the last 1000 blocks on Ethereum? I need to confirm a payment I sent landed."},{"title":"Audit outgoing token activity","prompt":"Show me all USDC transfers sent out from 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe over the last 2000 blocks on Ethereum — I want to see the counterparty and amount for each."},{"title":"Monitor token flows for compliance","prompt":"Pull the full transfer history for ERC-20 token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on wallet 0x1234567890abcdef1234567890abcdef12345678 over the last 500 blocks so I can review who it's been transacting with."}],"resultDescription":"Returns a JSON object with the wallet address, chain name and ID, the scanned block range (fromBlock, toBlock), a count of transfers found, and an array of up to 50 transfers each containing: direction (in/out), counterparty address, token amount, token symbol, token contract address, block number, and transaction hash. Also includes a truncated flag if more than 50 results exist.","failureModes":["Malformed or invalid wallet address returns HTTP 400, no charge applied","Invalid or non-ERC-20 token contract address may return empty transfer list or error","Block range outside 1–2000 may be clamped or rejected","No transfers found in range returns empty transfers array with count 0","Network congestion or RPC timeout may cause delayed or failed response"],"whenToPreferThis":"Use this endpoint when you need a historical list of ERC-20 token transfers (in or out) for a specific Ethereum wallet, particularly to confirm a payment arrived, audit outgoing sends, or trace counterparties. Prefer this over eth_token_balance when you need movement history rather than a current snapshot. Best suited for recent activity within the last ~2000 blocks (~6–7 hours on Ethereum); for older history, a different archive-node endpoint would be needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:13:56.754Z","isFirstParty":false,"canonicalSlug":"ethereum-erc-20-token-transfer-history-d12c9844"}