> ## Documentation Index
> Fetch the complete documentation index at: https://docs.davidhf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insider trades

> Form 4–style insider transactions with rich filtering.

Insider trades are Form 4–style transactions by company insiders: purchases, sales, and option exercises with shares, price, and value. Two endpoints serve the same underlying data: `/insider-trades` adds rich filters, while `/insider-transactions` is the simpler list form. Non-operating instruments return no insider trades.

## Insider trades

```http theme={null}
GET /insider-trades
```

| Parameter          | Type    | Required | Default | Description                          |
| ------------------ | ------- | -------- | ------- | ------------------------------------ |
| `scenario_id`      | string  | Yes      | -       | The world to read from.              |
| `ticker`           | string  | No       | all     | Restrict to one ticker.              |
| `name`             | string  | No       | all     | Filter by insider name.              |
| `transaction_type` | string  | No       | all     | Filter by type (e.g. `buy`, `sell`). |
| `filing_date_gte`  | date    | No       | -       | Filed on or after.                   |
| `filing_date_lte`  | date    | No       | -       | Filed on or before.                  |
| `limit`            | integer | No       | 10      | Page size (max 200).                 |
| `offset`           | integer | No       | 0       | Pagination offset.                   |

<CodeGroup>
  ```bash cURL theme={null}
  curl -s "https://api.davidhf.com/insider-trades?scenario_id=<id>&ticker=AAPL&transaction_type=sell&filing_date_gte=2026-01-01" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  dd.insiders.trades(scenario_id="<id>", ticker="AAPL", transaction_type="sell", filing_date_gte="2026-01-01")
  ```
</CodeGroup>

```json theme={null}
{
  "insider_trades": [
    {
      "id": "ins_...",
      "ticker": "AAPL",
      "insider_name": "Jane Doe",
      "role": "CFO",
      "transaction_date": "2026-02-14",
      "transaction_type": "sell",
      "shares": 25000,
      "price": 188.5,
      "value": 4712500,
      "filing_date": "2026-02-16",
      "details": { "...": "..." }
    }
  ]
}
```

## Insider transactions

```http theme={null}
GET /insider-transactions
```

The simpler list form: same row shape, fewer filters.

| Parameter     | Type    | Required | Default | Description             |
| ------------- | ------- | -------- | ------- | ----------------------- |
| `scenario_id` | string  | Yes      | -       | The world to read from. |
| `ticker`      | string  | No       | all     | Restrict to one ticker. |
| `as_of`       | date    | No       | -       | Point-in-time cutoff.   |
| `limit`       | integer | No       | 50      | Page size (max 200).    |
| `offset`      | integer | No       | 0       | Pagination offset.      |

<CodeGroup>
  ```bash cURL theme={null}
  curl -s "https://api.davidhf.com/insider-transactions?scenario_id=<id>&ticker=AAPL" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  dd.insiders.transactions(scenario_id="<id>", ticker="AAPL")
  ```
</CodeGroup>