Risk Metrics

Residual mean-reversion factor — user-defined basket aggregate

Aggregate the Phase D L3 residual mean-reversion signal across a user-supplied basket of up to 500 tickers. Returns the weighted aggregate of residual_z_5d, signal_strength, industry_percentile, residual_autocorr_5d, and l3_subsector_er, plus decile and signal-quality-quintile histograms and per-member rows. Equal-weight default; supply weights[] aligned 1:1 with tickers for custom weighting. Optional signal_quality_min_quintile (1–5) gates members below that quintile out of the aggregate while keeping them visible in the members[] rows.

Trust contract: tickers not present in ds_erm3_residual_signal at the latest teo are silently dropped — the upstream mask is the source of truth for "good" rows. The response's coverage block surfaces what was requested, what landed in the basket, and which tickers were missing.

Companion to:

  • GET /residual-signal/{ticker} — per-name snapshot + history.
  • GET /residual-signal/latest — full universe cross-section.
  • GET /residual-signal/decile/{n} — one decile bucket.

Combo-input factor — see the per-ticker route for the framing and capacity disclosure that's repeated on every response.

Billing: $0.02 per request.

post/signals/residual-reversion/basket

Request

  • Base URL: https://riskmodels.app/api
  • URL: https://riskmodels.app/api/signals/residual-reversion/basket
  • Auth: HTTP bearer

Request body

tickersstring[] required

Symbols to aggregate (1–500). Aliases (e.g. GOOGL→GOOG) resolved.

weightsnumber[]

Optional non-negative weights aligned 1:1 with tickers. Equal-weight when omitted. Sum need not be 1 — the aggregator normalizes.

signal_quality_min_quintileinteger

Optional gate on signal_quality_quintile. Phase B: gross Sharpe rises from ~0.79 (universe) to ~1.28 at quintile 5. Members below this still appear in members[] with passed_quality_gate=false but do NOT contribute to the aggregate.

Response

Basket aggregate, distributions, and per-member rows.

as_of_datestring date
capacity_notestring
methodology_linkstring

Changes

No recorded changes to this operation across all 1 revision of this API.