# Cross-Asset Volatility & Risk-Adjusted Return API
> The risk dashboard for the whole multi-asset book — how volatile each asset class is, how much it returned, and how much return it paid per unit of risk, computed live from Yahoo Finance (no key, nothing stored). Return without risk is meaningless; this puts them side by side. For every instrument — equities, bonds, gold, oil, commodities, FX and crypto — it measures the annualised realised volatility (the standard deviation of daily returns, the market's fear gauge), the trailing return, a Sharpe-style risk-adjusted return (return per unit of volatility) and the worst peak-to-trough drawdown over the window. The ranking endpoint returns the universe ranked by whichever you choose — volatility, Sharpe, return or drawdown — so you can see the calmest and wildest assets and who paid the best risk-adjusted return. The asset endpoint returns one instrument's full risk profile. The universe endpoint lists what is covered. The cross-asset volatility / risk-adjusted-return ranking cut — distinct from the crypto-only volatility and risk APIs, the FX-only volatility API and the bring-your-own-series risk-metrics, CAPM and portfolio-optimiser calculators. It ranks live risk across asset classes.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/assetvolatility-api/..."
```

## Pricing
- **Free** (Free) — 760 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 16,900 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 89,500 calls/Mo, 16 req/s
- **Business** ($81/Mo) — 488,000 calls/Mo, 40 req/s

## Endpoints

### Ranking

#### `GET /v1/ranking` — Multi-asset universe ranked by volatility, Sharpe, return or drawdown

**Parameters:**
- `sort` (query, optional, string) — volatility, sharpe, return or drawdown Example: `sharpe`
- `window` (query, optional, string) — Lookback in days (20-250) Example: `90`
- `class` (query, optional, string) — Filter by class Example: `commodities`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetvolatility-api/v1/ranking?sort=sharpe&window=90&class=commodities"
```

### Asset

#### `GET /v1/asset` — One instrument full risk profile

**Parameters:**
- `asset` (query, required, string) — Asset key (see /v1/universe) Example: `gold`
- `window` (query, optional, string) — Lookback in days (20-250) Example: `90`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetvolatility-api/v1/asset?asset=gold&window=90"
```

### Universe

#### `GET /v1/universe` — Supported instruments

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetvolatility-api/v1/universe"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetvolatility-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/assetvolatility-api
OpenAPI spec: https://www.oanor.com/api/assetvolatility-api/openapi.json