Skip to main content
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

GET /insider-trades
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
namestringNoallFilter by insider name.
transaction_typestringNoallFilter by type (e.g. buy, sell).
filing_date_gtedateNo-Filed on or after.
filing_date_ltedateNo-Filed on or before.
limitintegerNo10Page size (max 200).
offsetintegerNo0Pagination offset.
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"
{
  "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

GET /insider-transactions
The simpler list form: same row shape, fewer filters.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
limitintegerNo50Page size (max 200).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/insider-transactions?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"