Help & FAQ

Quick answers to common questions about the Quant Signals trading system.

?
FAQ
Common questions answered
A-Z
Glossary
Key terms and concepts
!
Troubleshooting
Fix common issues

Frequently Asked Questions

Getting Started

Quant Signals is an automated stock trading and TSP optimization system. It uses quantitative analysis, machine learning, and rolling-window optimization to generate daily trading signals for S&P 500 stocks. The system includes 15 optimized portfolio variants spanning taxable accounts, taxable-in-IRA, and pure IRA strategies.

Go to and create a paper trading account. You can choose which variant group to track (taxable, taxable-in-IRA, IRA, or all 15). Each variant starts with $100,000 virtual capital and trades automatically based on daily signals.

The system runs 15 portfolio variants optimized via rolling-window validation studies. They're grouped into three categories:

  • Taxable (N1-N6) — Optimized for after-tax returns in a standard brokerage account
  • Taxable-in-IRA (N1i, N6i, N1ir) — Taxable strategies run in an IRA wrapper (no tax drag)
  • IRA (I1-I6, I9) — Purpose-built for IRA accounts, optimized for CAGR, Sharpe, or Calmar ratio

Market & Signals

The system classifies market conditions into five regimes: Bull Run, BULL, NEUTRAL, BEAR, and RECOVERY. This is based on SPY price action, VIX levels, and breadth indicators. The regime determines how aggressively the system trades — in bear markets, it reduces exposure and holds more cash.

This is likely because the risk gate is active. The system uses a 4-tier risk assessment. When Tier 3 or Tier 4 risk is triggered (high systemic or execution risk), all BUY orders are blocked as a protective measure. The system will resume buying when risk levels drop. High cash allocation in bear markets is by design — it protects capital.

Each variant has its own rebalance schedule, ranging from every 20 to every 110 trading days. The schedule was optimized per-variant during rolling-window optimization. You can see the next rebalance date on the Paper Trading dashboard. Rebalancing sells all positions and re-buys based on the latest signals.

Risk & Protection

  • Tier 1 — Portfolio Risk: Beta, volatility, and concentration within your holdings
  • Tier 2 — Market Risk: VIX level, market breadth, and momentum indicators
  • Tier 3 — Systemic Risk: Treasury yields, credit spreads, and macro conditions
  • Tier 4 — Execution Risk: Slippage estimates and transaction costs

When Tier 3 or 4 are triggered, the risk gate blocks all new BUY orders to protect capital.

The system uses 378 ML models trained at multiple probability thresholds to predict market crashes. It also incorporates advanced calibration techniques for improved classification accuracy — reducing false positives by 2.4x compared to simple threshold approaches. Predictions feed into the Tier 2 risk assessment.

TSP Switching

The TSP (Thrift Savings Plan) module is separate from the stock trading system. It uses ML models to predict when to switch between the C Fund (stocks) and G Fund (bonds). When the model detects high crash probability, it sends an alert to switch to the G Fund for capital preservation. Daily TSP prices are scraped automatically.

Glossary

CAGRCompound Annual Growth Rate. The annualized return of an investment over a period.
Calmar RatioCAGR divided by maximum drawdown. Higher is better. Measures return per unit of worst-case risk.
DrawdownThe peak-to-trough decline in portfolio value. Max drawdown is the worst such decline historically.
Kelly FractionPosition sizing method based on the Kelly Criterion. Determines optimal bet size given win probability and payoff ratio.
Optimization EngineThe system used to tune strategy parameters via rolling-window analysis across 12 time windows.
RegimeMarket state classification (Bull Run, BULL, NEUTRAL, BEAR, RECOVERY) that controls strategy aggressiveness.
Risk GateA protective mechanism that blocks BUY orders when systemic (Tier 3) or execution (Tier 4) risk is elevated.
Sharpe RatioRisk-adjusted return. Calculated as (return - risk-free rate) / volatility. Higher is better.
Stop LossAutomatic sell trigger when a position drops below a configured percentage from its entry or peak price.
TSPThrift Savings Plan. Federal employee retirement plan with C Fund (stocks) and G Fund (bonds).
VariantOne of 15 portfolio configurations, each with uniquely optimized parameters for stock selection, position sizing, and rebalancing.
VIXCBOE Volatility Index. Measures market fear/uncertainty. Used in Tier 2 risk assessment. Higher VIX = higher risk.
Rolling-Window ValidationOptimization method that trains on past data and validates on unseen future data across rolling windows to prevent overfitting.

Troubleshooting

Yellow "Stale data" banner at top of page

This means one or more data sources haven't updated recently. On weekends this is normal — market data doesn't update on Saturday/Sunday. On weekdays, check that the daily pipeline ran successfully. The banner auto-detects weekend gaps and adjusts thresholds accordingly.

Paper trading shows no recent trades

Check the market regime and risk gate status on the Market Cycle & Risk page. If the risk gate is active (Tier 3 or 4), all BUY orders are blocked. Also verify the rebalance schedule — each variant has a different interval (20-110 trading days). The system only trades on rebalance days unless stop-losses trigger.

Server takes a long time to load

The API runs on Render's free tier, which spins down after 15 minutes of inactivity. The first request after a cold start can take 30-60 seconds. Subsequent requests are fast. The system automatically retries on timeout.

Portfolio value seems wrong

Portfolio values are computed from the last daily snapshot. If the pipeline missed a day, values may lag. Check the Paper Trading dashboard for the last snapshot date. The nightly maintenance report flags gaps automatically.

Dashboard shows "Unable to connect"

Verify the API server is running. For local development, ensure python api/backend_api.py is active on port 5000. For cloud, check the Render dashboard for deployment status. The system auto-detects local vs. cloud based on hostname.

Page Guide

System OverviewHigh-level view of subscription status, recent signals, and portfolio summary
Paper TradingLive performance of all 15 variants with daily P&L, equity curves, and trade history
Current PortfolioToday's holdings, sector allocation, and position details
Backtest ResultsHistorical rolling-window backtest results for all 15 variants
Signal DashboardToday's trading signals, stock rankings, and filter results
Market Cycle & RiskCurrent regime classification, VIX status, and 4-tier risk breakdown
Crash PredictionML-based crash probability forecasts with advanced calibration
Recovery AdvisoryGuidance for re-entering the market after a drawdown or crash event
TSP SwitchingThrift Savings Plan C/G fund switching signals and history
Buy-In AdvisorSeasonal entry timing signals for dollar-cost averaging and lump-sum decisions
AccountPaper trading account management, variant selection, and performance overview
Getting Started GuideStep-by-step setup for Taxable, IRA, and TSP accounts with your first signals
How It WorksPlain-English explanation of the system's approach, variants, and risk management
GlossaryDefinitions of all terms, metrics, and abbreviations used across the dashboard
Sector ExposureCurrent sector allocation breakdown and rotation timeline
Variant AnalysisRisk-return comparison and performance scatter across all 15 variants
Benchmark ComparisonSide-by-side performance against SPY and other benchmarks
Signal EffectivenessHistorical accuracy and hit rates for each signal type
Unified Risk DashboardCombined 4-tier risk system with portfolio, market, systemic, and execution risk scores
Activity FeedRecent trades, signal changes, and system events across all variants
Automated TradingSetup and status for automated trade execution via Alpaca

Page last updated: loading...