{"uid":"cap_9veWy-Y5_llef0_phuKmh","slug":"erc-20-token-transfer-history-by-ethereum-address-1ccf7d6c","name":"ERC-20 Token Transfer History by Ethereum Address","description":"ERC-20 token transfer history for an Ethereum address (via Etherscan V2). Each transfer: hash, block, timestamp, from/to, token contract, name, symbol, decimals, and value (raw + decimal-adjusted). Optionally filter to one token contract. Paginate with page + offset. Defaults to Ethereum mainnet; other EVM chains by chainId where upstream coverage allows. Trace what tokens a wallet sent/received.","url":"https://2s.io/api/crypto/token-transfers","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["address"],"properties":{"page":{"type":"integer","minimum":1},"sort":{"enum":["asc","desc"],"type":"string"},"offset":{"type":"integer","maximum":100,"minimum":1},"address":{"type":"string"},"chainId":{"type":"integer","default":1,"minimum":1,"description":"EVM chain id; defaults to 1 (Ethereum). Other chains require upstream multichain coverage."},"contractAddress":{"type":"string","description":"Filter to one ERC-20 contract."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-qMolxkZbDNiPF_NWuEfn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the full ERC-20 token transfer history for an Ethereum (or EVM-compatible) wallet address, with optional filtering by token contract, via Etherscan V2.","exampleAgentPrompt":"Show me the ERC-20 token transfer history for Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want the most recent 25 transfers sorted newest first, and only show transfers for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":null,"resultDescription":"A paginated list of ERC-20 token transfer events for the specified address, each containing transaction hash, block number, Unix timestamp, from and to addresses, token contract address, token name, symbol, decimals, raw value, and decimal-adjusted value. Results can be filtered to a single token contract and sorted ascending or descending.","failureModes":["Missing required 'address' parameter returns a validation error","Invalid Ethereum address format may return empty results or an upstream error","Unsupported chainId returns an error or empty dataset if Etherscan lacks multichain coverage for that chain","Offset exceeding maximum of 100 returns a validation error","Rate limiting or upstream Etherscan API unavailability may return a 5xx error","Wallet with no ERC-20 transfers returns an empty result set"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 token transfer records for a specific Ethereum or EVM-compatible wallet address, especially when you need structured metadata (name, symbol, decimals) alongside raw transfer values. Prefer this over generic blockchain explorers when you need paginated, filterable results ready for agent consumption and are willing to pay per-call at a low fixed rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:57.543Z","isFirstParty":false}