Ownership — Insider trades

Per-transaction filings by officers, directors, and 10%+ holders. Most recent 100 transactions, newest first.

GET /v1/ownership/{ticker}/insider-trades basic+ US

Parameters

Name	Type	Req	Description
ticker	path	yes	Ticker symbol.

Example

curl -H "X-API-Key: rk_YOUR_KEY" \
  https://api.rockmoon.ai/v1/ownership/AAPL/insider-trades

r = requests.get(
    "https://api.rockmoon.ai/v1/ownership/AAPL/insider-trades",
    headers={"X-API-Key": "rk_YOUR_KEY"},
)
for t in r.json()["trades"][:5]:
    print(t["filed_on_date"], t["insider_name"], t["action_label"], t["post_trade_held_qty"])

const r = await fetch(
  "https://api.rockmoon.ai/v1/ownership/AAPL/insider-trades",
  { headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { trades } = await r.json();

Response 200

{
  "ticker": "AAPL",
  "market": "US",
  "count": 100,
  "trades": [
    {
      "id": 16232798,
      "accession": "0001780525-26-000005",
      "document_type": "4",
      "filed_on_date": "2026-03-17",
      "ingested_at": "2026-04-14 03:15:16",
      "issuer_cik": "0000320193",
      "issuer_name": "Apple Inc.",
      "insider_cik": "0001780525",
      "insider_name": "Newstead Jennifer",
      "officer_title": "SVP, GC and Secretary",
      "role_officer": 1,
      "role_director": 0,
      "role_ten_percent_owner": 0,
      "role_other": 0,
      "action_code": "M",
      "action_label": "option_exercise",
      "src_trans_code": "M",
      "src_acquired_disposed": "D",
      "src_relationship": "Officer",
      "ownership_mode": "direct",
      "src_direct_indirect": "D",
      "instrument_kind": "rsu_grant",
      "security_label": "Restricted Stock Unit",
      "is_derivative": 1,
      "is_equity_swap": 0,
      "pre_trade_held_qty": 301040.0,
      "post_trade_held_qty": 240832.0,
      "strike_price_usd": null,
      "exercise_open_date": null,
      "expiration_date": null,
      "deemed_execution_date": null,
      "provenance": "form345_dera:2026q1_form345"
    }
  ]
}

Errors

HTTP	Code	Cause
403	`upgrade_required`	Basic+ required.
404	`ticker_not_found`	Unknown ticker.
429	`rate_limit_exceeded`	Rate limit hit. Honor `Retry-After`.

Source forms — what Forms 3, 4 and 5 are

Insider data comes from the SEC's Section 16 filing trio. The document_type field tells you which form a row came from:

Form 3 — initial statement. Filed within 10 days of someone becoming an insider (officer, director, or 10%+ owner). It is a holdings snapshot, not a trade — Form 3 rows appear in the holdings data rather than here.
Form 4 — change in ownership. Due within 2 business days of any transaction (purchase, sale, grant, option exercise, gift). This is the bulk of the rows here and the most time-sensitive signal.
Form 5 — annual statement. Due 45 days after fiscal year end; catches small or exempt transactions (gifts, sub-threshold acquisitions) that didn't require a Form 4, plus late reports.
Amendments carry the /A suffix (4/A, 5/A).

Notes

Action codes: P open-market purchase, S open-market sale, M exercise of derivative, A grant, F tax withholding, G gift. action_label is the inferred plain-text version.
Freshness: new filings are ingested from EDGAR once a day — a Form 4 filed today is queryable by the next morning (UTC-7). provenance shows the ingest path: form345_edgar:<filing date> for the daily feed, form345_dera:<quarter> for rows reconciled from the SEC's quarterly structured data sets.
Coverage: US filers. Other markets return an empty trades array (JP has large-holdings events instead).