# Insider & Institutional Ownership API
> Live US insider and institutional ownership data from Nasdaq — no key, nothing stored. The "who owns and who is trading" view of a stock: the corporate insiders (executives and directors) buying and selling their own shares, and the institutions holding the stock, distinct from the price-quote, movers and earnings APIs in the catalogue. The insider endpoint returns recent insider transactions — the insider, their relation to the company, the date, whether it was a buy or sell, the shares, the price, the computed value and the resulting holding — plus the 3-month and 12-month open-market buy/sell summary. The institutional endpoint returns the institutional ownership picture: the percent of shares held by institutions, the total holdings value and the largest holders with their position size, recent change and market value. The positions endpoint returns the institutional position-change breakdown — how many holders increased, decreased, opened new or sold out their positions, and the shares involved. Build insider-signal trackers, smart-money dashboards, ownership-change alerts and due-diligence tools on top of real Nasdaq ownership data. Look up any US stock by its ticker symbol; values and share counts are returned as clean numbers.

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

## Pricing
- **Free** (Free) — 10,000 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 165,000 calls/Mo, 10 req/s
- **Pro** ($28/Mo) — 760,000 calls/Mo, 28 req/s
- **Scale** ($61/Mo) — 2,750,000 calls/Mo, 60 req/s

## Endpoints

### Insider

#### `GET /v1/insider` — Recent insider transactions and buy/sell summary

**Parameters:**
- `symbol` (query, required, string) — Stock ticker Example: `AAPL`
- `limit` (query, optional, string) — Max transactions (default 20, max 50) Example: `20`

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

### Institutional

#### `GET /v1/institutional` — Institutional ownership and largest holders

**Parameters:**
- `symbol` (query, required, string) — Stock ticker Example: `AAPL`
- `limit` (query, optional, string) — Max holders (default 15, max 50) Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/insider-api/v1/institutional?symbol=AAPL&limit=15"
```

### Positions

#### `GET /v1/positions` — Institutional position changes

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

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

### Meta

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

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


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