# FINRA — Zapi reference

> Posisi short terkonsolidasi FINRA per saham per tanggal setelmen, dua kali sebulan.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/finra
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## FINRA

**Category:** finance · **Slug:** `finra`
**Detail page:** https://zpi.web.id/api/finance/finra

Posisi short terkonsolidasi FINRA per saham per tanggal setelmen, dua kali sebulan.

**Tags:** finra, short-interest, usa, stock, finance

### Short Interest

Riwayat posisi short satu saham, atau seluruh pasar pada satu tanggal setelmen. Termasuk days-to-cover dan perubahan dari periode sebelumnya.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:finra/short-interest`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | no | Ticker symbol. Omit only when `date` is set. |
| `date` | string | query | no | Settlement date (YYYY-MM-DD). Settlements land mid-month and month-end. |
| `length` | number | query | no | Rows to return (default 20, max 500) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:finra/short-interest?symbol=AAPL&date=2026-07-15&length=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:finra/short-interest?symbol=AAPL&date=2026-07-15&length=20", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:finra/short-interest?symbol=AAPL&date=2026-07-15&length=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 8,
  "items": [
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 3.06,
      "changeShares": 6021464,
      "changePercent": 4.28,
      "shortInterest": 146547784,
      "settlementDate": "2026-07-15",
      "averageDailyVolume": 47952794,
      "previousShortInterest": 140526320
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 1.73,
      "changeShares": -3722156,
      "changePercent": -2.58,
      "shortInterest": 140526320,
      "settlementDate": "2026-06-30",
      "averageDailyVolume": 81121306,
      "previousShortInterest": 144248476
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 2.76,
      "changeShares": -11637548,
      "changePercent": -7.47,
      "shortInterest": 144248476,
      "settlementDate": "2026-06-15",
      "averageDailyVolume": 52343843,
      "previousShortInterest": 155886024
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 3.38,
      "changeShares": 17103306,
      "changePercent": 12.32,
      "shortInterest": 155886024,
      "settlementDate": "2026-05-29",
      "averageDailyVolume": 46064146,
      "previousShortInterest": 138782718
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 2.74,
      "changeShares": 4107444,
      "changePercent": 3.05,
      "shortInterest": 138782718,
      "settlementDate": "2026-05-15",
      "averageDailyVolume": 50565316,
      "previousShortInterest": 134675274
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 2.93,
      "changeShares": 252487,
      "changePercent": 0.19,
      "shortInterest": 134675274,
      "settlementDate": "2026-04-30",
      "averageDailyVolume": 45944025,
      "previousShortInterest": 134422787
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 3.39,
      "changeShares": 7651503,
      "changePercent": 6.04,
      "shortInterest": 134422787,
      "settlementDate": "2026-04-15",
      "averageDailyVolume": 39674165,
      "previousShortInterest": 126771284
    },
    {
      "name": "Apple Inc. Common Stock",
      "market": "NNM",
      "symbol": "AAPL",
      "daysToCover": 2.96,
      "changeShares": 2579254,
      "changePercent": 2.08,
      "shortInterest": 126771284,
      "settlementDate": "2026-03-31",
      "averageDailyVolume": 42873045,
      "previousShortInterest": 124192030
    }
  ],
  "total": 206,
  "source": "finra",
  "symbol": "AAPL",
  "latestSettlement": "2026-07-15"
}
```

---


_Generated: 2026-08-08T12:07:42.463Z_