Cryptolean
// Methodology · risk

Risk metric — reconstruction, not a clone.

Current definition risk-v1. Charts stamped with it were computed by src/metrics/risk.py, and every value plotted for a past date could have been computed on that date.

Definition and failure modes

Definition (v1):

raw   = log(close) - log(SMA(close, ma_days))
adj   = raw * index ** diminishing_factor        # index = 1..N calendar days
risk  = (adj - adj.expanding().min()) / (adj.expanding().max() - adj.expanding().min())

The index ** f term compensates for diminishing returns: log deviations from the mean shrink cycle over cycle, so later cycles need to be scaled up to reach comparable extremes. Normalisation is expanding-window on purpose — a global min/max would leak future information and make every historical value a lie.

Version this. Changing diminishing_factor changes every historical chart.

Version history

Newest first. Each entry says what changed and whether values that had already been published moved with it, followed by the sentence from the module that decided the verdict.

  1. no version bump2026-08-05Additive

    SMOOTHING_DAYS=14 added as a display constant. compute() output UNCHANGED — the six pinned numbers do not move.

    Output was added. Nothing already published changed, so every chart drawn under the previous version still reads the same.

    • unchangedSMOOTHING_DAYS=14 added as a display constant. compute() output UNCHANGED — the six pinned numbers do not move.

    Logged without a version bump. The module argues the computed output was byte-identical, which is why no chart stamp distinguishes before from after — so it is recorded here instead.

  2. risk-v12026-08-05InitialCurrent

    f=0.395, ma=365d. Phase 0 gate: 6/6 on cycle-risk extremes. Deliberately not retuned to 0.625 to force the Apr-2021 price-date reading. See PHASE0_RESULT.md.

    The first version of this metric. There is no earlier definition to restate.

Charts drawn with it

46 charts name this metric in their readout line.

Current version
risk-v1
Versions on record
2
First dated
2026-08-05
Restatement policy
Never moved
Never restated. Every bump on record added output without redefining what was already there.
Charts
46
Source
src/metrics/risk.py
Public functions
compute, smooth
Machine-readable
catalog.json · llms.txt