Api V2 Signals Action Get

Latest Action Card — single, decisive trade instruction.

The Playbook Engine fuses Market Posture (the MSI regime), advanced

• basic signals, and live structural levels into one Card per cycle. A Card is either a specific trade (BUY_PUT_DEBIT, SELL_CALL_SPREAD, BUY_IRON_CONDOR, etc.), a position-management directive, or STAND_DOWN when no pattern matches current structure.

STAND_DOWN is an earned outcome, not equivocation — it ships with a near_misses[] list naming the closest patterns and the specific trigger conditions they failed.

Outside the regular session (09:30 ET to the close) the answer is always STAND_DOWN with rationale "Market closed", empty near_misses, and context.session = "closed": no pattern is evaluated on a pre-market or after-hours print.

Params: underlying (default SPY). Returns 404 when no signal_score row exists for the symbol yet.

Returns: see docs/playbook_catalog.md §2 for the full schema. Trade Card example:

{
  "underlying": "SPY",
  "timestamp": "2026-05-01T18:42:13Z",
  "action": "SELL_CALL_SPREAD",
  "pattern": "call_wall_fade",
  "tier": "0DTE",
  "direction": "bearish",
  "confidence": 0.68,
  "size_multiplier": 0.6,
  "max_hold_minutes": 90,
  "legs": [
    {"expiry": "2026-05-01", "strike": 678.0, "right": "C", "side": "SELL", "qty": 1},
    {"expiry": "2026-05-01", "strike": 683.0, "right": "C", "side": "BUY",  "qty": 1}
  ],
  "entry":  {"ref_price": 678.40, "trigger": "at_touch"},
  "target": {"ref_price": 675.00, "kind": "level", "level_name": "max_pain"},
  "stop":   {"ref_price": 680.03, "kind": "premium_pct", "level_name": "call_wall_break"},
  "rationale": "Price $678.40 pinned at call wall $678.00, net GEX $7.1B, confirmed by trap_detection → call credit spread at the wall.",
  "context": {"...regime, msi, levels, signals_aligned..."},
  "alternatives_considered": []
}

STAND_DOWN example:

{
  "underlying": "SPY",
  "timestamp": "...",
  "action": "STAND_DOWN",
  "pattern": "stand_down",
  "tier": "n/a",
  "direction": "non_directional",
  "confidence": 0.0,
  "rationale": "No tradable structure. Closest patterns: call_wall_fade.",
  "near_misses": [
    {"pattern": "call_wall_fade",
     "missing": ["price 0.45% from call_wall (needs <= 0.20%)"]}
  ],
  "context": {"msi": 32.5, "regime": "chop_range"}
}

Notes. The Card is computed on demand from the latest persisted signal state and persisted when it is a trade. A pattern issues one Card per idea: while its last Card on the symbol is inside its hold window it stays quiet. Each pattern must also clear the entry bar its graded record on the symbol has earned (track_record in context); a pattern that has been losing there needs far more confidence or is paused.