# Sector Rotation RRG (Relative Rotation Graph) API
> Where each S&P 500 sector sits on the rotation map versus the market, computed live from Yahoo Finance (no key, nothing stored). The Relative Rotation Graph is how professional allocators visualise sector rotation: it plots each sector on two axes — relative strength (is it out- or under-performing the S&P 500) and relative momentum (is that relative strength improving or fading) — and the combination lands each sector in one of four quadrants that rotate clockwise over time: Leading (strong and getting stronger), Weakening (strong but losing steam), Lagging (weak and getting weaker) and Improving (weak but turning up). Money rotates Improving to Leading to Weakening to Lagging, so the quadrant tells you not just who is winning but who is next. This computes each of the eleven SPDR sectors' RS-Ratio and RS-Momentum against the S&P 500 and places it in its quadrant. The rrg endpoint returns the whole rotation map; the sector endpoint returns one sector's coordinates and quadrant; the sectors endpoint lists what is covered. The sector-rotation RRG / quadrant cut — distinct from the relative-strength ranking (a one-dimensional list), the sector price/performance feed and the correlation APIs. It shows the rotation, not just the ranking.

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

## Pricing
- **Free** (Free) — 700 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 16,200 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 87,500 calls/Mo, 16 req/s
- **Business** ($80/Mo) — 476,000 calls/Mo, 40 req/s

## Endpoints

### RRG

#### `GET /v1/rrg` — The full sector rotation map: every sector RS-Ratio, RS-Momentum and quadrant

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

### Sector

#### `GET /v1/sector` — One sector RRG coordinates and quadrant

**Parameters:**
- `sector` (query, required, string) — Sector key/alias (see /v1/sectors) Example: `technology`

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

### Sectors

#### `GET /v1/sectors` — The eleven S&P 500 sectors

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

### Meta

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

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


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