{"uid":"cap_aSVEJaJnnkob9zI_JqdPR","slug":"erc-20-token-transfers-9e14b769","name":"ERC-20 Token Transfers","description":"Recent ERC-20 token transfer events for a wallet address on Ethereum in one call: token name/symbol, decimal-adjusted value, and counterparties -- from Etherscan's V2 API. Optionally filter to one token via contract_address. Supports optional limit (default 25, max 100). $0.01/call.","url":"https://www.x402financialdata.com/token-transfers/:address","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"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"EVM wallet address"}}},"queryParams":{"type":"object","required":[],"properties":{"chain":{"enum":["eth"],"type":"string","description":"Which chain to query. Only 'eth' is supported right now."},"limit":{"type":"integer","description":"Max transfers to return, default 25, max 100."},"contract_address":{"type":"string","description":"Optional ERC-20 token contract address to filter to."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_mQCwtjAkWypOWYl86VJVt","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 recent ERC-20 token transfer events for an Ethereum wallet address, including token name/symbol, decimal-adjusted value, and counterparties","exampleAgentPrompt":"Show me the last 50 ERC-20 token transfers for the Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, filtered to just USDC transfers using contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"DeFi wallet activity audit","prompt":"Pull the last 100 ERC-20 token transfers for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 so I can see every token that's been moving in and out."},{"title":"Track USDC flows for a specific address","prompt":"Show me all recent USDC transfers for the wallet 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 — filter to just the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48."},{"title":"Monitor whale token movements","prompt":"Get the 25 most recent ERC-20 transfers for 0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503 and tell me which tokens they've been moving and to which counterparties."}],"resultDescription":"A list of recent ERC-20 token transfer events for the queried wallet, each including token name, token symbol, decimal-adjusted transfer amount, sender address, recipient address, transaction hash, block number, and timestamp. Results are sourced from Etherscan's V2 API and optionally filtered to a single token contract.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain value (non-eth) returns a validation error","Limit exceeding 100 is rejected or clamped","Invalid ERC-20 contract address for filtering returns empty results or an error","Wallet with no ERC-20 transfer history returns an empty list","Etherscan API downtime may cause upstream failures"],"whenToPreferThis":"Use this endpoint when you need ERC-20 token transfer history for a specific Ethereum wallet, especially when you want pre-parsed, decimal-adjusted token values and counterparty addresses in a single call without manually querying Etherscan. Prefer this over raw Etherscan API calls when operating in an x402 payment-enabled agent context. Use the contract_address filter when tracking a specific token like USDC or WETH to reduce noise.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:47:58.785Z","isFirstParty":false}