Liquidity Flow Tracker

WHAT IT DOES

This tool tracks the flow of tokens and liquidity across your transaction history, revealing how value moves between wallets, exchanges, and liquidity pools. It reads transaction history, token transfers, and liquidity pool interactions via on-chain calls, including logs, events, and transaction receipts. The tool identifies token flows between addresses, detects interactions with decentralized exchanges and liquidity pools, and builds a comprehensive flow network. You can filter by token address, set time range, and control flow depth. The output includes total flows and volume, token volume breakdown, pool interactions with pool type identification, and a detailed flow table showing from/to addresses, token, amount, and flow type.

HOW TO USE

Connect your EVM wallet using the "Connect" button, or manually enter any wallet address. Optionally enter a token address to filter flows for a specific token. Set the time range in days (1–365) and flow depth in hops (1–5). Select your network and click "Track liquidity flows" to generate the flow analysis. The tool will display the source address, network, token filter, time range, depth, total flows, total volume, token volume breakdown, pool interactions with pool type (Uniswap V3, Curve, Balancer, SushiSwap), and a flow table showing from/to addresses, token, amount, flow type (Pool or Transfer), and date.

TECHNICAL MECHANISM

The tool uses a graph-based traversal algorithm to track liquidity flows. Starting from the source address, it fetches transaction history and token transfer events via on-chain calls (simulated in this demo, but would use ethers.js provider calls with getLogs and getTransactionReceipt in production). Each token transfer is parsed for from/to addresses, token contract, amount, and timestamp. The tool identifies liquidity pool interactions by detecting transfers to/from known DEX and pool contracts, and classifies them by pool type based on interaction patterns. Flow depth controls how many hops from the source address are included in the graph. Token volume aggregation sums the USD value of all flows per token. The flow table displays all token movements with their associated addresses, amounts, and types. All calculations are performed live with user-provided parameters.

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. Liquidity flow tracking is limited to available historical data; older transactions may not be fully retrievable due to node limitations or RPC provider retention policies. 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 visualization purposes only and is not financial advice. Liquidity flows are based on historical data and may not reflect current token movements or pool interactions. Always verify transaction data 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.