Settings

Configure thresholds and notification settings

Detection Thresholds

Whale Trade Threshold ($)

Trades above this amount are flagged as whale

Mega Whale Threshold ($)

Trades above this are flagged as mega whale

Volume Spike HIGH (×avg)

Multiplier for HIGH level spike

Volume Spike MEDIUM (×avg)

Price Shift HIGH (%/hr)

% price change in 1hr for HIGH level

Price Shift MEDIUM (%/hr)

Signal Tuning

Alert Score Threshold

Minimum composite score to generate an alert (default: 55)

Min Signals Required

Minimum number of active signals to generate an alert (default: 2)

Divergence Max Score

Max score for price/volume divergence signal (default: 10)

Low Tier Min Volume ($)

Minimum 24h volume for low tier (default: $50, below = dormant)

These values are saved to the database and used by workers on next restart.

Alert Settings

Alert Cooldown (minutes)

Minimum time between same-type alerts per market

Minimum Severity to Send

Tier Polling Intervals (fixed)

Hot (>$100k vol)60s + WebSocket

Active (>$1k vol)5 minutes

Low (>$0 vol)15 minutes

Dormant ($0 vol)60 minutes

Telegram Bot

Bot Token

Get from @BotFather on Telegram

Chat ID

Your Telegram user ID or group ID

Note: Set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in your .env file. Changes here are not persisted to disk yet — configure via environment variables.