
WatchTower watches an equity list you define and prints or optionally delivers alerts from six monitors: price, news, earnings, sector, macro, and sentiment (VIX only). No hosted service or subscription. Equity only, not CFD, FX, or prop-firm.
Copy example configs to settings.yaml and watchlist.json and edit them. Monitors never fall back silently to the examples — they stop with a named error if a copy is missing.
Price: progressive % threshold breaches; same-sector correlation alert when 2+ names fire; no volume-spike or vol Z-score. News: Finnhub company-news and/or RSS, hash-deduped. Earnings: look-ahead dates; estimates and surprise % when present. Sector: average, outliers, same-direction momentum. Macro: Finnhub calendar (CPI, NFP, FOMC, PMI, similar US releases), actual vs consensus. Sentiment, VIX only: level, named bands, fear score 0–100, extreme alerts, trend vs prior. Alerts: Discord webhook, Telegram (bot token and chat id), or email (SMTP).
Requires Python 3.10+, requests, feedparser, pyyaml; internet for live fetches. Price, earnings, and sentiment use Yahoo or Sina (no key). Live news and macro need a Finnhub key (or RSS for news). Missing key or feeds: MissingApiKeyError — no invented events. Not a nine-module suite (no fundamentals, options-flow, Form 4/insider, analyst-ratings, or index-rebalance). Sentiment is not CNN Fear & Greed and has no put/call or social scores. Not a hosted real-time terminal, order-routing stack, or portfolio risk engine.