Skip to content

KB/signal

N1 distribution top score

Last verified

Auto-generated. This article is rebuilt from app/signals/config/signal_definitions.json by scripts/build_signals_kb.py. Edit the registry entry and re-run the script — do not edit this file directly.

N1 distribution top score

What it is

N1 distribution top score — registry key n1_distribution_score.

Raw dislocation score for the N1 distribution-top (short) archetype: |ret_5d| lifted by a relative-volume multiplier when primed. Higher = a clearer rollover off the highs on heavier volume. Comparable only within the N1 archetype (cross-archetype normalization is rank.py). Not persisted to daily_signals — lives in the screener_candidates table.

Data-pyramid tier

T3 — Lens. This metric sits at the lens layer of the platform’s six-tier data pyramid (T0 raw inputs → T5 actionable read). The tier reflects how far the value is from a raw measurement — not how strongly it is validated. Abstraction and validation are separate axes: a higher tier is not a claim of stronger evidence.

Horizon & validation

No validated skill horizon is on file for this metric — read it as context / a data carrier, not a validated edge. Stamps are added only when a gated research verdict lands.

Source

Source module: screener
Data source: computed

Derived metric — produced inside the platform (app/sources/screener.py or equivalent) rather than fetched as a raw upstream value. See the How it's computed section below for the formula.

How it’s computed

primed: |ret_5d| * (1 + max(rel_vol - 1, 0)); partial: |ret_5d| * 0.8; none: 0. ret_5d is a 5-day log return. Score is 0 when any core screen condition (near-52w-high + RSI<=rsi_current_max + momentum rollover + quality gate) fails. See app/screener/archetypes.py::evaluate_distribution_top.

Where it surfaces

Health-score / alignment role

Data carrier — no implication, no health-score contribution.

Persisted for downstream consumers (sparklines, base-rate matcher, calibration substrate) but does not classify into BULLISH / NEUTRAL / BEARISH and does not contribute to the 0-100 health score.

Release cadence