Get the latest quantum swing signal for a single S&P 500 ticker.
Returns TWO distinct facets — they answer different questions and are not
interchangeable:
* `verdict` (BUY | WAIT | EXIT, labelled BULLISH / NEUTRAL / BEARISH) —
what the model thinks of the stock. This is the same word, over the same
field, that the website shows a human. EXIT means "consider closing an
existing long", never "short it".
* `timing` (BUY | WAIT | AVOID | WATCH) — whether to put money in RIGHT
NOW. A stock the model likes can still be a poor entry today.
Alongside them: entry price, stop-loss, take-profit ladder (TP1/TP2/TP3),
position-size suggestion, and risk-reward ratio generated by the
Schrödinger + Feynman path-integral model. Data is refreshed on a
scheduled basis (typically every few hours).
A BUY verdict requires multi-signal convergence — a lone indicator never
triggers one. Conviction score (0–10) reflects signal agreement depth.
Call explain_signal to see the factor attribution — directional
probability, expected upside, tail downside, band calibration — with the
dominant driver and what argues against the call.
Limits: S&P 500 universe only. Signal may be absent if the ticker was not
included in the latest scan run.
Timing: a BUY here is suppressed within 5 days of an earnings print — call
get_earnings_calendar to see the event date and gap-risk note before entry.
Args:
ticker: Stock ticker symbol (e.g. "AAPL", "MSFT", "NVDA"). Case-insensitive.
Returns a dict with signal, quantum forecast, generated_at, stale flag,
and disclaimer embedded in the payload.