OptionForge - Alpaca Options Alpha Trading Agent

Most retail options trading bots suffer from two fatal flaws: deploying unhedged, static credit spreads that blow up when volatility spikes, or relying on unconstrained LLM loops that hallucinate strikes and violate margin limits. The Autonomous Options Alpha Agent introduces an institutional-grade, multi-strategy system pairing explainable LLM intelligence with uncompromising deterministic Python hard risk gates. Core Capabilities: 1. Dual-Layer Decoupled Architecture: LLMs propose strategy hypotheses; deterministic Python code strictly authorizes capital execution. Zero strike hallucinations via strict 21-character OCC formatting. 2. Regime-Adaptive Strategy Selection: Continuous Black-Scholes Greeks modeling measures 52-Week Implied Volatility Rank (IVR), IV Percentile (IVP), and ADX trend momentum across liquid index ETFs and mega-caps. Dynamically deploys Bull Put Spreads, Bear Call Spreads, and Iron Condors in high-IV regimes (IVR > 50), directional debit spreads in strong trends, and halts trading in low-volatility chop to preserve cash. 3. Hybrid Alpaca Infrastructure: Combines the Alpaca MCP Server for explainable LLM tool reasoning, the Alpaca CLI for lightweight operations, and the official alpaca-py Python SDK for low-latency WebSocket quote streaming and sub-millisecond mathematical risk checks. 4. Multi-Model LLM Gateway: Seamlessly switches between official partner Featherless AI (serverless open-source models: Qwen 2.5 72B, GLM-5.2) and Google Gemini (gemini-2.0-flash) with synthetic deterministic fallback for 100% uptime. 5. Deterministic Hard Risk Gates: Enforces 5% max risk per trade, 40% portfolio margin ceiling, 5% daily circuit breaker, 10% max drawdown, automated 60% profit harvesting, and 2.5x stop losses on a fresh $100,000 paper trading account evaluated strictly by Total Account Equity.