# Put/Call Ratio & Options Sentiment API
> Live (15-minute delayed) options put/call sentiment analytics for US stocks and indices, computed from CBOE's public delayed-quotes feed. The ratio endpoint aggregates the entire option chain into the headline sentiment gauges — the put/call ratio by volume and by open interest, the total put and call volume and open interest, the contract counts, and the underlying price with its 30-day implied volatility (IV30) — plus a plain-language sentiment lean. The expiries endpoint breaks the put/call ratio down by expiration date, giving the term structure of sentiment. The strikes endpoint maps call-versus-put volume and open interest across strikes for an expiration, showing where positioning sits. This is the computed options-sentiment and positioning view — ratios and skew, not a contract dump — distinct from the raw options-chain, the volatility-index and the options-pricing calculators in the catalogue. US index options use an underscore-prefixed symbol (_SPX, _VIX); a ratio above 1 means more puts than calls (defensive/bearish lean). Live, no key on the upstream, nothing stored.

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

## Pricing
- **Free** (Free) — 19,000 calls/Mo, 4 req/s
- **Starter** ($9/Mo) — 225,000 calls/Mo, 12 req/s
- **Pro** ($26/Mo) — 960,000 calls/Mo, 30 req/s
- **Scale** ($60/Mo) — 3,450,000 calls/Mo, 80 req/s

## Endpoints

### Sentiment

#### `GET /v1/expiries` — Put/call ratio per expiration (term structure)

**Parameters:**
- `symbol` (query, required, string) — US ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/putcallratio-api/v1/expiries?symbol=AAPL"
```

#### `GET /v1/ratio` — Headline put/call ratios + sentiment

**Parameters:**
- `symbol` (query, required, string) — US ticker; index uses underscore prefix Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/putcallratio-api/v1/ratio?symbol=AAPL"
```

#### `GET /v1/strikes` — Call-vs-put volume & OI across strikes

**Parameters:**
- `symbol` (query, required, string) — US ticker Example: `AAPL`
- `expiry` (query, optional, string) — Expiration YYYY-MM-DD (defaults to nearest) Example: `2026-06-19`
- `limit` (query, optional, string) — Max strikes (max 300) Example: `60`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/putcallratio-api/v1/strikes?symbol=AAPL&expiry=2026-06-19&limit=60"
```

### Meta

#### `GET /v1/meta` — Spec

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


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