# 52-Week High/Low Range Screener API
> Where every major asset sits in its one-year range — across stocks, indices, bonds, commodities, FX and crypto — computed live from Yahoo Finance (no key, nothing stored). The 52-week high/low is the single most-watched level in markets: assets breaking to new 52-week highs are in confirmed uptrends and chased by momentum, while new 52-week lows mark capitulation, and the "new highs / new lows" list is a classic breadth and momentum read. This places each instrument in its range as a 0-100 position (0 = sitting on its 52-week low, 100 = at its 52-week high), with how far it is below the high and above the low, and flags fresh new highs and new lows. The screener endpoint returns the whole multi-asset universe ranked by range position — what is breaking out at the top and breaking down at the bottom — plus the new-high and new-low lists. The asset endpoint drills into one instrument. The universe endpoint lists what is covered. The 52-week-range / new-highs-new-lows momentum cut across asset classes — distinct from the crypto Donchian-breakout screener (crypto only) and the single-quote, index, commodity and stock price feeds, which carry the 52-week high/low as a field but do not rank it across a multi-asset book.

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

## Pricing
- **Free** (Free) — 780 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 17,800 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 91,500 calls/Mo, 16 req/s
- **Business** ($79/Mo) — 498,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Multi-asset universe ranked by 52-week range position with new-high/low lists

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

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

### Asset

#### `GET /v1/asset` — One instrument 52-week range detail

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

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

### Universe

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

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

### Meta

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

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


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