product image

WatchTower — Portfolio Monitoring Tool: Price Alerts, News & Earnings Tracker

$19

Self-hosted Python equity watchlist with six monitors. You run it locally.

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.