Skip to content
github-actions[bot] edited this page Sep 5, 2026 · 4 revisions

🎯 SignalSync Documentation

Automated, risk-defined algorithmic chart pattern screener for the S&P 500.
Scans 500+ equities daily on GitHub Actions with zero paid APIs and delivers verified morning setups.

tests daily scan discussions License: MIT


πŸ’‘ Why SignalSync?

  • πŸ›‘οΈ Strictly Defined Risk: Every confirmed signal includes an entry price, an ATR-buffered structural stop, and a reference target. Setups requiring >15% risk are automatically dropped.
  • πŸ“ No Forced Patterns: Strict geometric curvature algorithms (parabolic regression vs. V-shapes) coupled with a composite quality score ($\ge 60$).
  • πŸ“ˆ Trend-Gated: Built-in SMA50 / SMA200 trend gates prevent fighting dominant macro momentum.
  • πŸ”¬ Rigorously Backtested: Includes a walk-forward replay engine and historical git signal tracker to measure real hit rates and R multiples.
  • ⚑ Serverless & Free: Runs completely within GitHub Actions free tier using Yahoo Finance data. No servers, no subscriptions.

πŸ“Š Supported Bullish Setups

Pattern Setup Type Trigger Condition Structural Stop Reference Target
β˜• Cup & Handle Continuation Daily close above handle high Handle low βˆ’ 0.25 ATR Entry + Cup depth
πŸ‘€ Inverse Head & Shoulders Reversal Daily close above neckline Right shoulder low βˆ’ 0.25 ATR Entry + (Neckline βˆ’ Head)
🐺 Bullish Wolfe Wave Reversal Daily close back above line 1–3 Point 5 low βˆ’ 0.25 ATR Line 1–4 at the ETA

Tip

CONFIRMED vs WATCHLIST: Setups breaking out on the latest bar are flagged CONFIRMED. Setups with completed geometry within 5% of their trigger wait on the WATCHLIST.


πŸ“š Documentation Hub

Explore the full technical design, algorithms, and configuration:

  • πŸ—οΈ Architecture and Data Pipeline
    Constituent loading, symbol normalisation (e.g. BRK.B β†’ BRK-B), Yahoo Finance throttling, last-bar alignment, and the nightly scan schedule.

  • πŸ“ Pattern Catalog
    Exact geometric criteria, parabolic RΒ² roundness formulas, neckline tilt calculations, Wolfe EPA/ETA projections, and score composition.

  • πŸŽ›οΈ Configuration and Tuning
    Reference guide for every threshold, quality score cutoffs, 5% watchlist proximity, age limits, and false-positive controls.

  • πŸ§ͺ Testing and Contributing
    Offline test harness, walk-forward backtester (tools/backtest.py), signal outcome tracking (tools/evaluate_signals.py), and how to add a pattern.


πŸ’¬ Community & Quick Links