📖 User Guide & Read Me
⏰ When to Run the Scanner
Do not run the scanner before 9:45 AM EDT. The options market requires 15-30 minutes after the opening bell to stabilize Implied Volatility (IV) and spread pricing. Running it too early will result in artificially inflated premiums and immediate stop-loss triggers.
📊 System Terminology
- Target Delta (Δ): Controls how far Out-Of-The-Money (OTM) or In-The-Money (ITM) the options are. Conservative mode targets ~0.65 (safer, ITM). Aggressive mode targets ~0.35 (riskier, OTM).
- Target DTE (Days to Expiration): Controls how far out in time the option expires. Conservative targets 45 days to reduce time decay. Aggressive targets 14 days for faster momentum plays.
- Strike Price: The specific pre-agreed price at which the option contract allows you to buy (Call) or sell (Put) the underlying stock before expiration.
- RSI (Relative Strength Index): Measures market momentum from 0 to 100. < 35 means a stock is mathematically oversold (cheap). > 65 means a stock is overbought (expensive).
- AI Sentiment Score (-1.0 to 1.0): The Gemini AI's reading of live news. 1.0 is extremely bullish (prime for Calls), -1.0 is extremely bearish (prime for Puts).
📥 Inbox / Recommendation Metrics
- Premium / Est. Cost: The per-share cost of the option contract. Because options represent 100 shares, the total required capital is calculated as (Premium × 100 × Quantity).
- Over Leverage Warning: A human-in-the-loop safeguard that triggers if a recommended trade requires a higher percentage of your total portfolio than your max allowed risk setting.
- AI Thesis: The fundamental reasoning generated by the AI agent after analyzing real-time web search results and news headlines.
- Momentum Add: If the AI recommends a stock you already own, it will only pass the scanner if your current position is up >20%, allowing you to safely press winners.
💼 Portfolio Metrics
- Live Prem (Current Val): The live, real-world value of your option contract. The app actively connects to the live market options chain to fetch the exact current bid/ask premium of your specific strike.
- Entry Prem (Cost Basis): The exact per-share dollar amount you paid to enter the trade.
- PnL (Profit and Loss): Your total return (in raw dollars and percentage).
- Unrealized: The live, fluctuating profit or loss on trades you currently hold. This is the metric the Guardian monitors.
- Realized: The permanently locked-in profit or loss from trades that have been officially closed and added back to your Bankroll.
🛡️ The Guardian Engine
The Guardian is the automated risk manager that constantly monitors your Active Holdings against live market data. It enforces three strict rules based on your custom Settings:
- Dynamic Trailing Stop: Unlike a static stop-loss that only looks at your buy price, the Guardian tracks the highest premium your contract reaches. It will automatically issue a SELL alert if the contract drops your set percentage (e.g., 20%) from its highest recorded peak, locking in gains before they vanish.
- Hard Take-Profit: Instantly issues a SELL alert the moment a contract hits your exact target profit percentage.
- PDT Protection: If "Allow Same-Day Trading" is disabled in your settings, the Guardian will intentionally ignore Take-Profit and Stop-Loss triggers on the exact same day you buy a contract, protecting smaller accounts from Pattern Day Trader violations.