# Cross-Asset Drawdown & Recovery Monitor API
> How far every major market is below its peak and how long it has been underwater, computed live from Yahoo Finance (no key, nothing stored). Drawdown is the risk investors actually feel: not volatility in the abstract, but the gap between today's price and the high-water mark, and the painful stretch spent climbing back. For every asset — equity indices, bonds, gold, oil, commodities, FX and crypto — this measures the current drawdown from its rolling peak, the worst (maximum) drawdown over the window, the date and level of the peak, how many days it has been underwater, and how much of the fall it has already recovered. The monitor endpoint returns the whole universe ranked by current drawdown — what is deepest underwater and what is back at new highs — with a summary of how many markets are in drawdown. The asset endpoint returns one market's drawdown card. The universe endpoint lists what is covered. The cross-asset drawdown / underwater-recovery cut — distinct from the FX-only drawdown API, the crypto all-time-high API and the cross-asset volatility API (which ranks risk-adjusted return, not the underwater curve). It answers how far from the highs, and how long.

## 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/assetdrawdown-api/..."
```

## Pricing
- **Free** (Free) — 740 calls/Mo, 2 req/s
- **Starter** ($10/Mo) — 17,200 calls/Mo, 6 req/s
- **Pro** ($31/Mo) — 90,500 calls/Mo, 16 req/s
- **Business** ($72/Mo) — 484,000 calls/Mo, 40 req/s

## Endpoints

### Monitor

#### `GET /v1/monitor` — Universe ranked by current drawdown with new-high list and drawdown count

**Parameters:**
- `class` (query, optional, string) — Filter by class: equities, bonds, commodities, fx, crypto, real_estate Example: `equities`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetdrawdown-api/v1/monitor?class=equities"
```

### Asset

#### `GET /v1/asset` — One market drawdown & recovery card

**Parameters:**
- `asset` (query, required, string) — Asset key (see /v1/universe) Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/assetdrawdown-api/v1/asset?asset=bitcoin"
```

### Universe

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

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

### Meta

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

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


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