Get an execution-ready trade plan for one S&P 500 ticker — entry, exit, size, risk.
This is the decision tool: it turns the raw quantum signal into a concrete,
risk-first plan you can act on. Unlike get_signal (which reports the raw
verdict and levels), get_trade_plan wraps them in execution discipline:
- entry_plan: the exact entry trigger, a "don't chase" rule, and the
invalidation level that kills the thesis.
- exit_plan: a take-profit ladder (TP1/TP2/TP3), scale-out guidance, a
volatility-aware trailing-stop rule, and a 3-month time-stop.
- sizing: position-size suggestion, worst-case max-drawdown %, and R:R.
FALSE-NEGATIVE BIAS (by design — a missed trade is cheap, a bad trade is
expensive): a plan is only `actionable=true` when the verdict is BUY/EXIT
AND concrete entry+stop levels exist AND risk-reward is >= 2:1. In every
other case — WAIT/AVOID, missing levels, or thin R:R — the tool returns
`actionable=false`, emits NO entry trigger, and states the `no_trade_reason`
loudly. Treat "no trade" as the correct, common answer, not a failure.
Always check regime_gate: a BUY from a scan that had no live market snapshot
is lower confidence. When `data_freshness` is present the payload is saying,
in a sentence, that the last scheduled run did not land and the levels
predate the current tape — relay that sentence; its absence means the data
arrived on schedule and needs no mention.
Always check get_earnings_calendar: an entry within 5 days of a print
carries gap risk a stop can't protect, and swing BUYs are suppressed there.
Args:
ticker: Stock ticker symbol (e.g. "AAPL", "MSFT", "NVDA"). Case-insensitive.
Returns a dict with actionable flag, verdict, entry_plan, exit_plan, sizing,
regime_gate, calibration, and disclaimer embedded in the payload.