Risk Metrics

Cross-sectional rankings leaderboard

Best names (lowest rank_ordinal) at the latest teo for one metric × cohort × window. Same rank_percentile rule as GET /rankings/{ticker} (100 = best). Requires all three filters.

get/rankings/top

Request

  • Base URL: https://riskmodels.app/api
  • URL: https://riskmodels.app/api/rankings/top
  • Auth: HTTP bearer

Query parameters

metric'mkt_cap' | 'gross_return' | 'sector_residual' | 'subsector_residual' | 'er_l1' | 'er_l2' | 'er_l3' required
cohort'universe' | 'sector' | 'subsector' required
window'1d' | '21d' | '63d' | '252d' required
limitinteger

Response

Leaderboard rows and lineage metadata.

teostring date nullable
metricstring
cohortstring
windowstring
limitinteger
_metadataobject

Example response

{
  "_agent": {
    "cost_usd": 0.005,
    "latency_ms": 145,
    "request_id": "req_abc123xyz",
    "confidence": {
      "overall": 0.98
    },
    "data_freshness": "2026-02-21T10:30:00Z",
    "billing_code": "ticker_returns_v2"
  }
}

Changes

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