SEC Form 4 Insider Alerts — New-Filings-Only Delta Monitor

Pricing

Rating

Developer

Actor stats

Categories

Share

Run this on a schedule and get only the NEW insider transactions since your last run — never a re-dump of the whole window. It watches the issuers, CIKs, insider names, or transaction codes you care about, keeps a persistent snapshot of everything it has already seen, and emits just the fresh Form 4 activity as clean alert rows. It is the monitoring layer on top of our EDGAR Form 4 scraper: built for daily/hourly watchlists, not bulk historical pulls.

What it does

On each run it pulls recent Form 4 filings using NexGenData's owned sec-form-4-insider-trading-scraper, explodes each filing into its individual insider transactions, labels each transaction code (purchase, sale, grant, option exercise, etc.), records what it has seen in a persistent snapshot, and in delta mode emits only transactions that are new since the last run. It monitors recent filings on a rolling window — it is not a full real-time institutional feed, and it does not provide investment advice.

How it differs from the scrapers

• Form 4 Insider Trading Scraper — bulk, one-off pulls direct from EDGAR XML. Use it for historical back-tests.
• Form 4 Insider Tracker — an OpenInsider screener feed with role/value/cluster filters.
• This monitor — a scheduled alert engine. It de-duplicates across runs via a persistent snapshot and surfaces only NEW transactions, so a daily/hourly schedule never re-emits the same filing twice.

Use cases

• Watch one executive — a daily scheduled job that alerts only when a watched executive (by name or CIK) files a new Form 4.
• Slack / email / webhook alerts — fire integrations on net-new insider trades, not duplicates.
• Compliance watch — monitor a fixed CIK list with delta dedup across runs.
• Event-driven desks — watch a basket of tickers for fresh P/S activity.
• Low-noise feeds — where re-emitting the same week's filings every run is unacceptable.

Recommended setup

Run once in full mode to baseline, then schedule daily delta runs. The first delta run per watch query records a baseline and emits nothing (expected); after that you get only new transactions. Set lookback_days to comfortably cover the gap between runs.

Sample input

{
"tickers":["TSLA","NVDA"],
"ciks":[],
"insider_names":["Musk Elon"],
"transaction_codes":["P","S"],
"lookback_days":3,
"mode":"delta",
"max_filings":500,
"include_raw":false
}

Sample output

One row per NEW transaction since the last run:

{
"accession_number":"0001209191-26-000123",
"change_type":"added",
"cik":"1318605",
"ticker":"TSLA",
"company":"Tesla, Inc.",
"insider_name":"Musk Elon",
"insider_role":"Chief Executive Officer",
"is_director":true,
"is_officer":true,
"is_ten_percent_owner":true,
"transaction_date":"2026-06-27",
"transaction_code":"S",
"transaction_label":"sale",
"security_title":"Common Stock",
"shares":50000.0,
"price":410.22,
"transaction_value":20511000.0,
"filing_url":"https://www.sec.gov/Archives/edgar/data/1318605/.../doc4.xml",
"matched_watch":"musk elon",
"detected_at":"2026-06-29T12:00:00+00:00"
}

Inputs

Transaction labels

P→purchase, S→sale, A→grant / award, M→option exercise / conversion, D→disposition, F→tax withholding / payment, G→gift, J→other transaction; unknown codes are kept as unknown_code.

Outputs

accession_number, change_type, cik, ticker, company, insider_name, insider_role, is_director, is_officer, is_ten_percent_owner, transaction_date, transaction_code, transaction_label, security_title, shares, price, transaction_value, ownership_nature, filing_date, filing_url, matched_watch, detected_at (plus raw when enabled).

Delta mode vs full mode

• full — emits every matching transaction in the window and refreshes the snapshot.
• delta — emits only transactions whose (accession + insider + code + date) has not been seen before. First delta run baselines and emits nothing; later runs emit only new transactions.

FAQ

Q: How do I get alerts when an insider buys or sells?

A: Schedule this actor; in delta mode it emits only Form 4 transactions it hasn't seen before, filtered to your watched tickers/CIKs/insiders.

Q: Can I track a specific insider by name?

A: Yes — insider_names matches reporting owners as whole-word phrases (e.g. "Musk Elon").

Q: What's the difference between this and the Form 4 scraper?

A: The scraper does bulk one-off pulls; this monitor de-duplicates across runs and surfaces only new activity.

Q: Why did my first run return nothing?

A: The first delta run is a silent baseline that records current filings; subsequent runs emit only what's new.

Q: How often should I run it?

A: Daily covers the 2-business-day filing deadline; hourly for event-driven watchlists. Set lookback_days to comfortably cover the gap between runs.

Limitations

This is an alerting tool, not investment or legal advice. It monitors recent Form 4 filings on a rolling window via the owned source Actor; it is not a full real-time institutional coverage feed. Coverage and timing follow SEC EDGAR's publication of Form 4 filings. Always confirm against the official filing before acting.

Related actors

• SEC Form 4 Insider Trading Scraper
• SEC Form 4 Insider Tracker
• Insider Cluster Buy Detector
• SEC Form 3 New Insider Tracker
• SEC Form 144 Restricted Stock Sales Tracker