Auto-generated. This article is rebuilt from FastAPI route introspection by scripts/build_api_kb.py. Edit the route docstring in app/ and re-run the script — do not edit this file directly.

GET /api/v1/signals/alignment

Handler: app.signals.routes.get_signal_alignment
Methods: GET

Description

Full signal-price alignment detail with all category implications.

Response carries schema_version (currently "2026.07" per ALIGNMENT_SCHEMA_VERSION). Bump on any breaking shape change to the per-category sub-objects. The gamma category is live-driven (Signal Alignment revamp, 2026-06): its value carries the live net dealer-gamma read where present, it returns fused legs/confidence, and it carries an additive live_read_days history-depth marker.

The response additionally carries weighted_alignment_pct_legacy (whole-row updated_at aging) and weighted_alignment_pct_per_leg (per-leg vintage obs-date aging) plus an alignment_freshness_per_leg flag echo, so the two paths can be diffed live. The served weighted_alignment_pct honors the ALIGNMENT_FRESHNESS_PER_LEG env flag — DEFAULT ON since PR-3 (2026-06), the per-leg path, after the FR-002 soak; set ALIGNMENT_FRESHNESS_PER_LEG=0 to revert to the legacy aging.

Categories: 12 total (11 active by default + 1 flag-gated). The eleven default categories in canonical insertion order are dark_pool, gamma, credit, breadth, energy, growth_expectations, correlations, volatility, inflation, carry_risk, liquidity. The twelfth, news_sentiment, is flag-gated behind ENABLE_AI_SENTIMENT_ALIGNMENT — when unset (default), the category is absent from the response and the 11-category surface stays byte-identical to pre-R13 per DOCTRINE P8. The canonical registry lives at app/signals/implications.py:IMPLICATION_FUNCS.

The baseline query parameter selects the SPY return window used as the alignment reference (3d default since 2026-05; 5d available for backward compatibility / longer-trend reads). Both returns are computed regardless and surfaced under spy_direction.

Enriched for the Signal Alignment card: each category carries a severity intensity (soft/medium/hard), a state_changed_at timestamp drawn from walking history until the category’s implication last flipped, and a score contribution in points. Top-level payload also carries a pct_history series (last 10 daily snapshots), a baseline_by_regime rollup (90d averages with sample counts), a velocity block (5d delta), and a transmission_profile key so the frontend can look the ordering up in ui/src/data/signal-transmission-order.json. Consumers that only need the classic alignment dict can ignore the new keys — they don’t replace anything in the existing contract.

Parameters

Curl

curl -s https://bigclawd.com/api/v1/signals/alignment