# 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"
```

**Response:**
```json
{
    "data": {
        "trend": "rising",
        "market": "US",
        "source": "Nasdaq",
        "symbol": "AAPL",
        "change_pct": 12.32,
        "shares_short": 155886024,
        "change_shares": 17103306,
        "days_to_cover": 3.3841,
        "settlement_date": "05/29/2026",
        "avg_daily_volume": 46064146,
        "prior_shares_short": 138782718,
        "prior_settlement_date": "05/15/2026"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:20.683Z",
        "request_id": "4e7419af-3bff-4c36-9c34-0bc796a9fceb"
    },
    "status": "ok",
    "message": "Short interest retrieved successfully",
    "success": true
}
```

### 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"
```

**Response:**
```json
{
    "data": {
        "count": 24,
        "market": "US",
        "source": "Nasdaq",
        "symbol": "AAPL",
        "history": [
            {
                "shares_short": 155886024,
                "days_to_cover": 3.3841,
                "settlement_date": "05/29/2026",
                "avg_daily_volume": 46064146
            },
            {
                "shares_short": 138782718,
                "days_to_cover": 2.7446,
                "settlement_date": "05/15/2026",
                "avg_daily_volume": 50565316
            },
            {
                "shares_short": 134675274,
                "days_to_cover": 2.9313,
                "settlement_date": "04/30/2026",
                "avg_daily_volume": 45944025
            },
            {
                "shares_short": 134422787,
                "days_to_cover": 3.3882,
                "settlement_date": "04/15/2026",
                "avg_daily_volume": 39674165
            },
            {
                "shares_short": 126771284,
                "days_to_cover": 2.9569,
                "settlement_date": "03/31/2026",
                "avg_daily_volume": 42873045
            },
            {
                "shares_short": 124192030,
                "days_to_cover": 3.2578,
                "settlement_date": "03/13/2026",
                "avg_daily_volume": 38121907
            },
            {
                "shares_short": 129553812,
                "days_to_cover": 3.2556,
                "settlem
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Look up a stock by its ticker (symbol=AAPL). US short interest is reported around the 15th and the end of each month; share counts are numbers and days-to-cover is shares-short over average daily volume.",
        "source": "Nasdaq public short-interest feed (api.nasdaq.com/api/quote/{symbol}/short-interest, live)",
        "service": "shortinterest-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/current": "Latest short interest with change from the prior period (symbol=AAPL).",
            "GET /v1/history": "Full settlement-by-settlement short-interest timeline (symbol=AAPL)."
        },
        "description": "Live short-interest data for US stocks from Nasdaq — the 'how heavily is it shorted, and is a squeeze building' view. current = the latest short-interest reading (shares sold short, average daily volume, days-to-cover) with the change from the prior period; history = the full settlement-by-settlement timeline. Live, no key, nothing stored. Days-to-cover (short interest divided by average daily volume) is the headline squeeze metric. Distinct from the quote, movers, insider and analyst APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:20.855Z",
        "request_id": "cd66441a-7dc3-4be9-871c-4858077b7b13"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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