SEC Insider Cluster-Buy Watchdog

Scans a company's official SEC EDGAR Form 4 filings and flags cluster buys: multiple different company insiders (executives, directors, 10% owners) buying stock on the open market within a tight window of each other. That pattern — several people with inside knowledge independently choosing to buy at the same time — is a far stronger signal than any one executive's purchase, and it's the one thing every other Form 4 Actor on the Store skips: they list recent filings; this one scores them.

No API key, no scraping, no third-party data vendor. Every field traces back to one of three official, free SEC endpoints:

• sec.gov/files/company_tickers.json — SEC's own ticker → CIK map
• sec.gov/cgi-bin/browse-edgar?...&type=4&output=atom — a company's Form 4 filing index
• the form4.xml ownership document for each filing

SEC's Fair Access policy asks automated callers to send a descriptive User-Agent with a real contact email on every request — there is no key to register. Put your email in the contactEmail input field and this Actor sends it only to sec.gov, as SEC itself asks.

What you get

One dataset row per watched ticker/CIK:

{
  "identifier": "XYZ",
  "cik": "0001234567",
  "ticker": "XYZ",
  "issuer_name": "Example Corp",
  "found": true,
  "form4_filings_scanned": 12,
  "buy_transactions_in_window": 3,
  "cluster_detected": true,
  "conviction_score": 78,
  "distinct_insiders": 3,
  "insider_names": ["Doe Jane", "Roe John", "Smith Pat"],
  "window_start": "2026-09-10",
  "window_end": "2026-09-16",
  "span_days": 6,
  "total_shares": 42000,
  "total_value_usd": 1850000.0,
  "officer_or_director_count": 2,
  "ten_percent_owner_count": 1,
  "transaction_count": 3,
  "buy_events_in_cluster": [ /* one entry per qualifying transaction */ ]
}

conviction_score (0-100) combines: how many distinct insiders bought, what fraction were officers/directors, the total dollar size, and how tight the buying window was relative to the window you allowed.

Input

Field	Description
watchlist	Tickers (e.g. "AAPL") or raw CIK numbers to watch. Required.
contactEmail	Your email, sent only to sec.gov in the User-Agent header, per SEC's own Fair Access request.
lookbackDays	Only purchases dated within this many days count. Default 30.
clusterWindowDays	Max span between the earliest and latest buy in a cluster. Default 10.
minClusterInsiders	Minimum distinct insiders required to call it a cluster. Default 2.
maxFilingsToScanPerIssuer	How many of the issuer's most recent Form 4 filings to pull. Default 40.

Why this matters

A single insider's open-market purchase is noisy — it can mean anything from a scheduled plan to personal conviction. Several different insiders buying independently, within days of each other, with no shared grant or plan behind it, is the pattern professional insider-tracking services charge subscriptions to surface. This Actor computes it directly from SEC's own free filings, on your own schedule, with no subscription and no key.

Notes

• Only non-derivative, open-market purchases (Form 4 transaction code P, shares acquired) are counted toward a cluster. Option exercises, gifts, and sales are parsed but excluded from the cluster signal by design.
• SEC EDGAR is a free public service with no published rate-limit key, but the Actor paces its own requests conservatively and retries transient failures (429/5xx/connection resets) automatically.