Transaction Categorizer

WHAT IT DOES

This tool automatically categorizes your wallet's transaction history into meaningful groups, helping you understand your on-chain activity at a glance. It reads transaction history for the connected wallet via on-chain calls, including logs, events, and transaction receipts, and assigns each transaction to a category based on protocol signatures and interaction patterns. Categories include DeFi Swaps, Lending/Borrowing, Transfers/Receives, NFT Purchases, Gas/Network Fees, Yield Farming, and Other. The tool provides a summary breakdown with transaction counts, total value per category, and percentage distribution, along with a list of recent transactions showing date, hash, category, amount, and type.

HOW TO USE

Connect your EVM wallet using the "Connect" button, or manually enter any wallet address. Set the time range in days (1–365 days) to limit the transaction history analysis. Select your network and click "Categorize transactions" to fetch and analyze your transaction history. The tool will display your address, network, time range, total transaction count, total value, a category breakdown table with counts and values, and a list of recent transactions with their assigned categories. This helps you track spending patterns, identify which protocols you interact with most, and understand your on-chain activity distribution.

TECHNICAL MECHANISM

The tool uses a multi-stage transaction analysis pipeline. First, it fetches transaction history for the specified address via on-chain calls (simulated in this demo, but would use ethers.js provider calls in production). Each transaction is analyzed for interaction patterns: ERC-20 transfers, contract calls, and event logs. The tool applies a rule-based classification system: transactions to known DEX routers (Uniswap, Sushiswap, etc.) are categorized as "DeFi Swap"; interactions with lending protocols (Aave, Compound) as "Lending/Borrowing"; ERC-721/ERC-1155 transfers as "NFT Purchase"; direct ETH/token transfers between EOAs as "Transfer/Receive"; internal transactions or fee payments as "Gas/Network Fees"; yield-generating protocol interactions as "Yield Farming"; and all others as "Other." The category breakdown aggregates counts and total ETH values for each category, and the most recent transactions are displayed with their classifications. In this demo, realistic transaction patterns are simulated for visualization purposes.

WHAT IT CANNOT SEE

The tool cannot view transactions on non-EVM chains (e.g., Solana, Bitcoin) or protocols that are not integrated with the tool's data sources. It cannot show real-time pending transactions or mempool activity—only confirmed on-chain transaction history is available. It cannot access wallet data without explicit user connection or manual address entry. It cannot detect off-chain holdings or centralized exchange balances. It cannot categorize transactions involving contracts not recognized by the tool's heuristics—these will be assigned to "Other." The tool's data sources may have rate limits or require API keys for production use. It does not provide financial advice or guarantee the accuracy of aggregated data.

PLEASE NOTE

This tool is for informational and tracking purposes only and is not financial advice. Transaction categorization relies on heuristics and may not be 100% accurate for all protocol interactions. Always verify your transaction history directly on-chain using a block explorer. The tool's data sources are subject to rate limits and availability. This tool only works with EVM-compatible chains. Use at your own risk.