KB / api
GET /api/v1/signals/alignment
Last verified
Auto-generated. This article is rebuilt from FastAPI route introspection by
scripts/build_api_kb.py. Edit the route docstring inapp/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.05.1" per
ALIGNMENT_SCHEMA_VERSION). Bump on any breaking shape change to
the per-category sub-objects.
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
| In | Name | Type | Default | Description |
|---|---|---|---|---|
| query | baseline | str | '3d' |
Curl
curl -s https://bigclawd.com/api/v1/signals/alignment