# Bollinger Bands & Squeeze Screener API
> Which markets are coiled for a breakout and which are stretched to their bands, computed live from Yahoo Finance (no key, nothing stored). Bollinger Bands wrap a 20-day average in plus/minus two standard deviations; price riding the upper band is strong, the lower band weak, and — the prized signal — when the bands pinch tight (a "squeeze"), volatility has compressed and a big move usually follows. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this computes each asset's bands, its %B (where price sits between the lower band at 0 and the upper at 100), the bandwidth and whether bandwidth is at a multi-month low (a squeeze, breakout pending). The screener endpoint returns the board with the markets in a squeeze, the ones breaking above the upper band and the ones breaking below the lower. The asset endpoint returns one market's Bollinger card. The universe endpoint lists what is covered. The Bollinger Bands / volatility-squeeze screener cut — distinct from the bring-your-own-candle technical-indicator APIs, the FX-only z-score API and the market-breadth API. It finds the coiled springs across the whole market.

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

## Pricing
- **Free** (Free) — 770 calls/Mo, 2 req/s
- **Starter** ($10/Mo) — 17,600 calls/Mo, 6 req/s
- **Pro** ($30/Mo) — 90,000 calls/Mo, 16 req/s
- **Business** ($72/Mo) — 490,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with squeeze list, band breakouts and bandwidth ranking

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

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

### Asset

#### `GET /v1/asset` — One market Bollinger Bands card

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

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

### Universe

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

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

### Meta

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

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


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