d6f73c217935
Insider-transaction news (SEC Form 4)
Dedicated insider feed (category=insider): SEC EDGAR Form 4 insider activity ONLY — one deterministic-templated row per filing event (a filing's non-derivative trades of one type and holding form, aggregated: total shares, volume-weighted average price and executed range, total value), surfaced shortly after filing, with the relevance score computed from the event's total (size, buy vs. sell, 10b5-1 plan or not). Same enriched shape, ticker and relevance_score >= 4 filtering, and cursor-based pagination as /api/news/. Equivalent to /api/news/?category=insider, surfaced as a first-class route. For aggregate stats instead of the stream, see /api/symbols/{ticker}/insider-summary/.
To watch for new filings, poll with sort=ingested rather than re-reading the newest page: a Form 4 is filed up to several days after the trade it reports, so a new event often enters the feed already below the head of the publish-ordered page. Delta mode orders by the moment the row became available, so it never misses one. The contract is identical to /api/news/?sort=ingested — see that endpoint for the full description.
Query parameters
Opaque cursor from a prior response's next_cursor. Omit for the newest page.
Filter to insider news that mentions this ticker. Delisted symbols return their history; a renamed company's current ticker also matches rows tagged with its former ticker.
Override the default ≥4 threshold. Insider rows score deterministically from the event's summed dollar value (plus buy/10b5-1 modifiers), so this acts as an "only large trades" dial — e.g. min_relevance=7 keeps roughly $10M+ events.
Filter on the same field each item's insider block reports: the event's Rule 10b5-1 status. Omit for every event; false returns discretionary trades only — the "hide pre-scheduled sales" dial, since a 10b5-1 ladder was set up months earlier and carries no timing decision; true returns plan events only. Event-level, like the field itself: a filing whose group mixes plan and discretionary tranches counts as a plan event on both. The two values partition the feed, so true and false pages always add up to the unfiltered one.
Items per page, default 10. Any value from 1 to 20 is accepted on every tier; 21-50 requires a Pro key. A value outside 1-50, or an over-20 page without a Pro key, returns 400.
published (default) is the reverse-chronological feed. ingested is delta-polling mode, with the same contract as on /api/news/: rows in the order they became available, ascending, next_cursor always returned (empty results = caught up), and all other filters applied unchanged. Prefer it for watching insider activity — a Form 4 is filed days after the trade it reports, so a new event routinely lands below the newest page of the publish-ordered feed and a poller reading only the head misses it. Cursors are mode-specific: a cursor is only valid with the sort mode that issued it (a mismatch returns 400).
Inclusive lower bound on time_published, identical in format and behaviour to the parameter on /api/news/ (ISO-8601, naive read as UTC, tier-gated with 403, refused with sort=ingested). Note which clock it is: time_published is when the filing reached the feed, NOT the insider's transaction_date reported in the insider block. A Form 4 is filed days after the trade, so a window over trade dates is a different question and this parameter does not answer it.
Inclusive upper bound on time_published. A bare date covers the whole day; same clock caveat as from_date.
Response
A page of enriched insider-transaction articles. Each item additionally carries the structured insider event block (side / shares / average price / total value / reporting owner) — populated on this endpoint only.
Example response
{
"results": [
{
"enrichment": {
"tickers": [
"NVDA"
],
"news_context_enhancement": {
"key_entities": [
{
"type": "company"
}
]
}
},
"story_id": "788e477c66f3849b",
"sources_count": 3,
"sources": [
"reuters.com",
"apnews.com",
"bloomberg.com"
],
"insider": {
"transaction_code": "S",
"shares": "25000",
"avg_price_usd": "187.32",
"total_value_usd": "4683000",
"insider_name": "STEVENS MARK A",
"insider_title": "Director",
"transaction_date": "2026-07-09",
"filed_at": "2026-07-11T20:31:04Z"
}
}
]
}