# riskmodels-app Risk Metrics API

**Canonical:** https://apis.io/apis/riskmodels-app/riskmodels-app-risk-metrics-api/  
**Provider:** riskmodels-app — https://apis.io/providers/riskmodels-app/  
**Base URL:** https://riskmodels.app/api  
**Documentation:** https://riskmodels.app/api-reference

riskmodels-app Risk Metrics API is one of 16 APIs that [riskmodels-app](https://apis.io/providers/riskmodels-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Risk Metrics. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

ERM3 factor hedge ratios, explained risk, and return decompositions.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| GET | `/metrics/{ticker}` | (internal/legacy) Latest risk metrics snapshot |
| POST | `/v4/decompose` | Decompose a position into named blocks (market / industry / style /… |
| GET | `/hedge-basket/{ticker}` | Structured hedge basket with a recommended hedge level and decision trace |
| GET | `/batch/latest-metrics` | Latest L3 hedge ratios and explained variances for up to 100 tickers |
| GET | `/metrics/{ticker}/snapshot.png` | Single-ticker risk snapshot as a PNG image |
| GET | `/snapshot/{entity_kind}` | Stock Deep Dive snapshot as PNG or PDF |
| POST | `/decompose` | (internal/legacy) Decompose a position into four additive bets with hedge ratios |
| GET | `/ticker-returns` | Daily returns time series with rolling hedge ratios (stocks and ETFs) |
| GET | `/returns` | Daily gross returns time series (single ticker) — REMOVED |
| GET | `/etf-returns` | Daily gross returns time series (ETF) — REMOVED |
| GET | `/returns-decomposition` | Full returns decomposition (L1/L2/L3 + optional Lstar) |
| GET | `/industry-panel` | Industry peer β cross-section |
| GET | `/stocks/{ticker}/commentary-bundle` | Stock commentary evidence bundle (one pull) |
| GET | `/cohorts` | Cohort residual statistics (cross-section) |
| GET | `/cohorts/series` | Cohort residual statistics (time series) |
| GET | `/cohorts/roster` | Cohort roster and variable catalogue (discovery) |
| POST | `/cohorts/pnl-decomposition` | Selection vs drift decomposition |
| POST | `/rankings/screen` | Cross-sectional rankings screen |
| GET | `/l3-decomposition` | L3 factor decomposition time series |
| GET | `/lstar` | Recommended hedge level (L*) per date with dispatched HRs |
| GET | `/residual-signal/{ticker}` | Residual mean-reversion factor — snapshot + history for one ticker |
| GET | `/residual-signal/latest` | Residual mean-reversion factor — active-universe cross-section |
| GET | `/residual-signal/decile/{n}` | Residual mean-reversion factor — members of decile n |
| POST | `/signals/residual-reversion/basket` | Residual mean-reversion factor — user-defined basket aggregate |
| GET | `/universe/{name}/members` | Active members of a named universe at a teo |
| GET | `/etf/factor-returns` | ETF factor returns snapshot (public scope) |
| POST | `/correlation` | Correlation vs macro factor returns |
| GET | `/metrics/{ticker}/correlation` | Correlation vs macro factors (query convenience) |
| GET | `/macro-factors` | Macro factor daily return series |
| GET | `/rankings/{ticker}` | Cross-sectional rankings snapshot |
| GET | `/rankings/{ticker}/badge` | Shields.io-style rank badge (JSON) |
| GET | `/rankings/top` | Cross-sectional rankings leaderboard |
| POST | `/batch/analyze` | (internal/legacy) Multi-ticker batch analysis |
| POST | `/batch/lstar` | Batch Lstar residual returns (up to 100 tickers) |
| POST | `/portfolio/exposure/history/daily` | Exposure history feed, daily — every trading day for a list of names (join… |
| POST | `/portfolio/exposure/history` | Exposure history feed — month-end model history for a list of names (join… |
| POST | `/portfolio/exposure` | Long/short portfolio exposure, ETF hedges and risk (signed dollar positions) |
| POST | `/portfolio/risk-index` | Portfolio risk index (L3 variance decomposition) |
| POST | `/portfolio/risk-snapshot` | (legacy) Portfolio risk snapshot (bundled PDF or JSON) |
| POST | `/snapshot` | Canonical JSON snapshot (portfolio or single ticker) |
| GET | `/snapshot/{entity_kind}/{id}/panels/{slug}` | Snapshot panel drill-down (artifact PNG/JSON) |
| GET | `/metrics/{ticker}/snapshot.pdf` | Single-ticker risk snapshot PDF |
| POST | `/chat` | AI Risk Analyst |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/riskmodels-app/openapi/riskmodels-app-risk-metrics-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-fund-holdings-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-ticker-returns-response-v3-schema.json
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-decompose-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-lstar-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-artifact-capability-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/riskmodels-app/json-schema/riskmodels-app-fund-metrics-response-schema.json

## Other riskmodels-app APIs (12)

- [riskmodels-app 13F Filers API](https://apis.io/apis/riskmodels-app/riskmodels-app-13f-filers-api/)
- [riskmodels-app Account API](https://apis.io/apis/riskmodels-app/riskmodels-app-account-api/)
- [riskmodels-app Authentication API](https://apis.io/apis/riskmodels-app/riskmodels-app-authentication-api/)
- [riskmodels-app Billing API](https://apis.io/apis/riskmodels-app/riskmodels-app-billing-api/)
- [riskmodels-app Compliance API](https://apis.io/apis/riskmodels-app/riskmodels-app-compliance-api/)
- [riskmodels-app Deprecated API](https://apis.io/apis/riskmodels-app/riskmodels-app-deprecated-api/)
- [riskmodels-app Discovery API](https://apis.io/apis/riskmodels-app/riskmodels-app-discovery-api/)
- [riskmodels-app Fundamentals API](https://apis.io/apis/riskmodels-app/riskmodels-app-fundamentals-api/)
- [riskmodels-app Funds API](https://apis.io/apis/riskmodels-app/riskmodels-app-funds-api/)
- [riskmodels-app Funds Data Plane API](https://apis.io/apis/riskmodels-app/riskmodels-app-funds-data-plane-api/)
- [riskmodels-app MCP API](https://apis.io/apis/riskmodels-app/riskmodels-app-mcp-api/)
- [riskmodels-app Plaid Integration API](https://apis.io/apis/riskmodels-app/riskmodels-app-plaid-integration-api/)

## Tags

Risk Metrics

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/riskmodels-app/riskmodels-app-risk-metrics-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/riskmodels-app/.