Protocol TVL Change Alert Tool

WHAT IT DOES

The Protocol TVL Change Alert Tool is an analytics tool that monitors Total Value Locked (TVL) changes in protocol vaults and pools over time. It reads current and historical token balances from the connected RPC provider, calculates the percentage change over a configurable block window, and triggers alerts when changes exceed user-defined thresholds. This helps protocol teams, investors, and stakeholders quickly identify significant TVL movements, respond to market events, and track protocol health.

HOW TO USE

Enter the addresses of your protocol vaults or pools (one per line). Set the block window to check (default 1000 blocks) and the alert threshold percentage (default 10%). Click "check TVL changes" to run the analysis. The tool compares current balances against historical balances at the specified block offset. Results display a summary of alerts triggered, a detailed table showing each vault's current and historical TVL, absolute change, percentage change, and status. Alerts are highlighted with visual indicators and detailed notifications.

TECHNICAL MECHANISM

The tool connects to the RPC provider and fetches current and historical balances for each vault address using eth_getBalance. For historical balances, it queries the provider with a specific block number parameter, retrieving the balance as it was at that point in time. The block window determines how far back to look—the tool calculates the historical block number as (currentBlock - blockWindow). For each vault, it computes the absolute change (currentTVL - oldTVL) and percentage change ((change / oldTVL) * 100). The tool evaluates the absolute percentage change against the user's threshold—if exceeded, an alert is triggered. The tool handles vaults that may not have existed at the historical block by checking for zero or null balances. Results are displayed with color-coded indicators: green for stable, amber for moderate changes, and red for significant changes exceeding the threshold. Multiple alerts are aggregated and displayed prominently.

WHAT IT CANNOT SEE

The tool cannot determine the composition of TVL without token price data—it only tracks native token balances (ETH) in each vault. It cannot account for token price fluctuations or market volatility, which can affect the value of TVL even when token quantities remain constant. The tool cannot detect TVL changes that occur through token price changes rather than actual deposits or withdrawals. It cannot access private protocol data or off-chain TVL sources. The tool cannot predict future TVL changes. It cannot distinguish between organic growth and whale manipulation without additional context. The tool cannot validate the accuracy of TVL data without external verification. It cannot account for cross-chain TVL not visible on the current chain. The tool cannot determine the cause of TVL changes (e.g., new features, market conditions, competition).

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains only. TVL is measured in the native token (ETH) of the chain—for protocols holding multiple tokens or stablecoins, this provides only partial visibility. The block window should be chosen based on the typical block time of the chain and the desired monitoring frequency. The tool provides estimates only and should be used as a starting point for TVL monitoring. For accurate TVL tracking across multiple token types, combine this tool with token price APIs and multi-token balance queries.