TradingAgents/.planning/research/FEATURES.md

7.0 KiB

Feature Landscape

Domain: Options trading analysis module for multi-agent AI trading system Researched: 2026-03-29

Table Stakes

Features users expect. Missing = product feels incomplete.

Feature Why Expected Complexity Notes
Options chain retrieval (strikes, expirations, bid/ask) Cannot analyze options without the data Low Tradier API, single endpoint
1st-order Greeks display (Delta, Gamma, Theta, Vega) Every options platform shows these Low Tradier returns these via ORATS
Implied volatility per contract Fundamental to options valuation Low Tradier returns bid_iv, mid_iv, ask_iv
IV Rank / IV Percentile Core metric for deciding whether to sell or buy premium Medium Requires 52-week IV history; Tradier historical data or yfinance for underlying HV
Options strategy recommendation (verticals, iron condors, straddles) The whole point of the module High LLM agent synthesis from Greeks + IV + directional bias
Max profit/loss and breakeven calculation Users need to understand risk before entering Medium Arithmetic on strike prices and premiums for each strategy type
DTE-based filtering Standard workflow: filter by 30-60 DTE for income strategies Low Simple date math on expiration dates
Probability of profit (PoP) estimation Expected by anyone familiar with tastytrade methodology Medium Approximated from delta (1 - delta for short options) or from IV

Differentiators

Features that set product apart. Not expected, but valued.

Feature Value Proposition Complexity Notes
2nd-order Greeks (Charm, Vanna, Volga) Most retail platforms only show 1st-order; this provides institutional-level insight Medium Compute via blackscholes library from spot + 1st-order Greeks
Gamma Exposure (GEX) analysis with dealer positioning SpotGamma-style analysis is premium ($199+/mo); providing this free is high-value Medium Numpy vectorized computation; interpretation via LLM agent
Volatility surface construction (SVI fitting) Visual and quantitative understanding of vol skew and term structure High SVI calibration via scipy; requires enough strikes per expiration
Gamma flip zone / Vol Trigger identification Identifies price levels where market maker hedging shifts from stabilizing to destabilizing Medium Derived from cumulative GEX sign change
Call Wall / Put Wall levels Support/resistance levels derived from options positioning Low Max gamma exposure strikes from GEX computation
Unusual options activity detection Identifies potential smart money positioning Medium Volume/OI heuristics; limited by lack of trade-level data
TastyTrade methodology rules engine Proven decision framework (IVR thresholds, 45 DTE entry, 21 DTE management, 50% profit targets) Medium Rules-based logic layer feeding into strategy selection agent
Multi-leg strategy construction with specific contracts Most analysis tools stop at "consider a put spread"; this names exact contracts High Agent must select strikes, expirations, and legs based on all analysis
Transparent reasoning chain Shows WHY each strategy was selected, educational value Medium LLM agent chain-of-thought exposed to user
MenthorQ-style composite scoring (0-5 Options Score) Single number summarizing options environment for quick decisions Medium Composite of IV rank, GEX regime, flow signals, vol skew

Anti-Features

Features to explicitly NOT build.

Anti-Feature Why Avoid What to Do Instead
Order execution / broker integration Scope creep; regulatory complexity; analysis-only mandate Output recommendation with contract symbols users can copy to their broker
Real-time streaming dashboard Project uses batch propagate() flow; streaming requires different architecture Provide point-in-time snapshots; tastytrade streaming is for data freshness, not live UI
0DTE strategy analysis Requires real-time infrastructure, sub-second data; batch analysis is stale before execution Focus on 7-90 DTE strategies where hourly data refresh is sufficient
Historical IV surface storage Requires ORATS subscription ($) or building own historical database Use current IV surface; flag historical context as future enhancement
Options backtesting engine Separate domain; options backtesting requires historical vol surfaces, fill simulation Defer to future project; existing backtrader dependency is for equities
Custom volatility models (Heston, local vol) Over-engineering; SVI is sufficient for equity options smile fitting Use SVI parametric model; only consider Heston if pricing exotics
Portfolio-level Greeks aggregation Would need to track user positions; analysis-only module has no position state Analyze individual strategies, not portfolios

Feature Dependencies

Options chain retrieval --> 1st-order Greeks display
Options chain retrieval --> IV per contract --> IV Rank/Percentile
Options chain retrieval --> GEX computation --> Gamma flip zone, Call/Put Walls
1st-order Greeks + spot price --> 2nd-order Greeks (Charm, Vanna, Volga)
IV per contract --> Volatility surface (SVI fitting) --> Vol skew analysis
IV Rank/Percentile + directional bias --> TastyTrade rules engine --> Strategy selection
GEX regime + IV environment + flow signals --> Composite score (Options Score 0-5)
Strategy selection --> Multi-leg construction --> Max P/L + breakeven + PoP
All analysis agents --> Options debate --> Options portfolio manager --> Final recommendation

MVP Recommendation

Prioritize (Phase 1 -- core analysis pipeline):

  1. Options chain retrieval via Tradier API (foundation for everything)
  2. 1st-order Greeks display (already in Tradier response)
  3. IV Rank / IV Percentile calculation
  4. GEX computation with Call/Put Wall levels
  5. Basic strategy recommendation (single agent, 3-4 strategy types)

Defer:

  • 2nd-order Greeks: Phase 2 -- requires blackscholes library integration
  • Volatility surface (SVI): Phase 2 -- complex calibration, needs robust error handling
  • TastyTrade rules engine: Phase 2 -- rules are well-defined but need IV Rank as input
  • Unusual activity detection: Phase 2 -- limited by data availability without trade-level feed
  • Multi-leg specific contracts: Phase 2 -- needs strategy selection working first
  • Composite scoring: Phase 3 -- needs all analysis components as inputs
  • Tastytrade streaming: Phase 3 -- enhancement for data freshness, not core functionality

Sources