GET
https://riskmodels.app/api/ticker-returnsReturns a daily time series of gross stock returns (returns_gross), V3 rolling hedge ratios (l3_mkt_hr, l3_sec_hr, l3_sub_hr), and explained-risk fractions (l3_mkt_er, l3_sec_er, l3_sub_er, l3_res_er) going back up to 15 years. Wire keys use abbreviated names; the Python SDK renames them to semantic form (l3_market_hr, etc.) via TICKER_RETURNS_COLUMN_RENAME. Cost: $0.005/call.
Parameters
| Param | Type | Description | Required | Default |
|---|---|---|---|---|
ticker | string | Ticker symbol. | Yes | — |
years | integer | Years of history (1–15). | No | 1 |
format | string | json (default), parquet, or csv. Tabular formats omit _metadata in body; use X-Risk-* headers. | No | json |
Response Codes
200Time series of daily returns and rolling hedge ratios.
401Missing or invalid Bearer token.
404Ticker not found.
429Rate limit exceeded.
GET https://riskmodels.app/api/ticker-returns?ticker=NVDA&years=1&format=jsonFull OpenAPI 3.0.3 specification available for download and tooling integration.