Real-time on-chain wallet monitoring with Telegram alerts and a local web dashboard.

What it does

- Monitors any wallet on BNB Smart Chain, Base, Ethereum, Polygon and Arbitrum (native and ERC-20 transfers, including transfers routed through a DEX router)

- Enriches each match with live token data from DexScreener: price, liquidity, market cap, age

- Filters noise with thresholds you control, so you only see the tokens you care about

- Analyzes the sending wallet: freshly funded wallet vs. dormant wallet reactivated after 14+ days, with a 0-100 risk score

- Detects coordinated group buys (several wallets buying the same token within seconds)

- Sends formatted Telegram alerts with token info, value in USD, risk score and a block-explorer link

- Runs 24/7: automatic RPC reconnection, retry with backoff, and a local SQLite cache that survives restarts

Web dashboard

Alerts feed, statistics, a settings page, and start/stop buttons for the bot. Password-protected and local-only by default.

What's included

- Full Python source code

- config.yaml and .env templates

- README and a step-by-step QUICKSTART guide

- 7 days of setup support by message (installation, configuration, first run)

What you need

- Python 3.10+

- A Telegram bot (free, created with @BotFather)

- A free RPC URL from Alchemy, Ankr or QuickNode

Safe by design

The bot only reads public blockchain data and sends Telegram messages. It never asks for private keys or seed phrases and never signs transactions.

License

One copy per buyer for personal or internal use. Resale, redistribution and sharing of the source code are not allowed.

Alerts are analytical signals, not financial advice.