Liquidity Flow

WHAT IT DOES

Liquidity Flow provides a comprehensive view of on-chain liquidity activity for any Uniswap-style pool contract on EVM-compatible chains. Enter a pool address, and the tool scans the most recent 5,000 blocks for all relevant events: swaps (token exchanges), mints (liquidity provision), burns (liquidity removal), and syncs (reserve updates). Each event is decoded and displayed with the involved addresses, transaction hash, and a link to the block explorer for deeper investigation. The tool categorizes events into clear sections—swaps, deposits, withdrawals, and reserve syncs—making it easy to understand the activity pattern of any pool. Whether you are tracking how liquidity moves into a new pool, monitoring large swap activity, or investigating a pool's health, Liquidity Flow surfaces the key on-chain data you need.

HOW TO USE

Connect your EVM wallet or simply paste any pool contract address into the input field. Select the network that matches the pool from the dropdown menu—the tool supports Ethereum Mainnet, Sepolia, BSC, Polygon, Arbitrum, Optimism, Avalanche, and Fantom. Click the "Track liquidity" button to begin the scan. The tool will fetch all event logs from the pool contract within the last 5,000 blocks and decode them into meaningful categories. A progress indicator shows the log scanning status, with automatic chunking and backoff to handle RPC limits. Results display the pool address, the number of blocks scanned, total events found, and categorized lists of swaps, deposits, withdrawals, and reserve updates. Each event includes the counterparty addresses and a link to the transaction on a block explorer.

THE TECHNICAL MECHANISM

Liquidity Flow's analysis engine uses event signature decoding to extract meaningful liquidity data from raw logs. The tool listens for four key event signatures: Swap (0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822), Mint (0x4c209b5fc8ad50758f13e2e1088ba56a560dff690a1c6fef26394f4c03821c4f), Burn (0x49995e5dd6158cf69ad3e9777c46755a1a826a446c6416992167462dad033b2a), and Sync (0x1c411e9a96e071241c2f21f7726b17ae89e3cab4c78be50e062b03a9fffbbad1). When a log matches one of these signatures, the engine extracts the indexed and non-indexed parameters from the event data, associating addresses with their roles (sender, recipient, liquidity provider) and displaying the event in its appropriate category. The tool uses chunked log scanning to respect RPC range limits—starting at 2,000-block chunks and halving on failure—ensuring the scan completes even on providers with restrictive caps. This approach provides a complete picture of pool activity without requiring the user to manually filter or decode event data.

WHAT IT CANNOT SEE

Liquidity Flow cannot trace flows across non-EVM chains such as Solana, Cosmos, or Bitcoin. It is limited to the most recent 5,000 blocks to maintain performance and respect RPC usage policies; older pool activity is not included. The tool cannot track liquidity through cross-chain bridges or layer-2 solutions that obscure the source chain—transactions through such protocols appear as interactions with the bridge contract, not as continuations of the liquidity path. It cannot definitively prove the ultimate source or destination of liquidity beyond on-chain heuristics; addresses may be other pools, exchanges, or unrelated users. The tool cannot access off-chain liquidity data, centralized exchange volumes, or private order book information. It also cannot decode custom pool implementations that use different event signatures from the standard Uniswap V2/V3 pattern. Token amounts are displayed as raw hexadecimal data and require additional decoding for human-readable values.

PLEASE NOTE

This tool is read-only and requires the BotGentz extension framework to be installed. It does not sign or send transactions. All data is fetched directly from the selected network's RPC endpoint and is not stored or transmitted externally. The tool is designed for Uniswap-style pools (V2 and V3 compatible) that emit the standard Swap, Mint, Burn, and Sync events. For custom or non-standard pool implementations, event decoding may be incomplete. This tool is free to use and intended for informational analysis, not as a substitute for professional DeFi auditing or liquidity monitoring.