Stock Guardian

What It Solves

Staring at a watchlist is usually not the hard part. The hard part is missing the event that matters: a threshold breach, a stop target, pre-market movement, or an end-of-day summary. stock-guardian is a price watcher, not a trading advisor. You define watched tickers, thresholds, target prices, and notification channels in config.json, and the platform schedules checks to alert you when conditions trigger.

How It Works

The core loop is: read config.json, check trading hours, fetch quotes, compute changes, compare threshold/target levels, apply cooldown and alert tier, aggregate non-urgent notifications, then write history.jsonl. It adapts to the AI platform: realtime uses WebSocket, high-freq uses fine-grained cron, and patrol uses heartbeat/schedule fallbacks. Quote sources prefer Sina Finance, Tencent Finance, and Yahoo Finance APIs, with search fallback when APIs are unavailable.

Boundaries

It focuses on monitoring, alerts, candlestick observation, and backtesting. It does not provide stock recommendations, buy/sell signals, or automated trading. Free quote feeds can be delayed, and stop alerts should not be treated as the only risk control. Urgent stop alerts bypass cooldown and are sent separately, while normal alerts are aggregated in a default 5-minute window to reduce noise.