A TypeScript pnpm monorepo that pulls 1m/5m market statistics and bulk kline archives from Binance and Bybit, detects pump/dump regimes, and sends alerts via Telegram. Try the live bot at @pumpdumpscreenerautobot.

Requirements: Node.js 20+, pnpm 9+, pm2. No exchange API keys needed—data comes from public bulk archives and REST endpoints. Setup requires free Binance and Bybit accounts, plus a Turso database and Telegram bot token.

Start with `pnpm install`, configure config.js with Turso and Telegram credentials, then run `pnpm build && pnpm db:bootstrap`. Production uses PM2 to manage three processes: pump-monitor (download/scan/alert pipeline), pump-bot (Telegram commands and classification), and pump-web (HTTP dashboard).

The system downloads historical candles, scans for pump/dump patterns, persists results to Turso, and broadcasts alerts with inline buttons. A manual review interface at /review allows human labeling of detected events for model improvement. Data grows continuously—scripts/prune-market-data.sh handles retention.

Configuration includes pump lookback periods, scan thresholds, caching options, and classifier permissions. The scanner uses worker threads for performance and supports incremental rescans for new market data.