# Stock Short Interest API
> Live short-interest data for US stocks from Nasdaq — no key, nothing stored. The "how heavily is it shorted, and is a squeeze building" view of a stock: the number of shares sold short, the average daily volume and the resulting days-to-cover, reported each settlement period, distinct from the quote, movers, insider and analyst APIs in the catalogue. The current endpoint returns the latest short-interest reading together with the change from the prior period — a rising or falling short position with the share delta and percent change. The history endpoint returns the full settlement-by-settlement timeline so you can see how the short position has trended over the year. Days-to-cover — short interest divided by average daily volume — is the headline squeeze metric: the higher it is, the longer shorts would need to buy back their position. Build short-squeeze scanners, bearish-positioning dashboards, risk overlays and contrarian-signal bots on top of real Nasdaq short-interest data. Look up any US stock by its ticker; share counts are returned as clean numbers. Note that short interest is reported about twice a month and a few non-Nasdaq listings may not be covered.

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

## Pricing
- **Free** (Free) — 11,800 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 178,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 765,000 calls/Mo, 28 req/s
- **Scale** ($54/Mo) — 2,780,000 calls/Mo, 60 req/s

## Endpoints

### Current

#### `GET /v1/current` — Latest short interest with change vs prior period

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

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

### History

#### `GET /v1/history` — Full settlement-by-settlement timeline

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

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

### Meta

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

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


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