Insider Trading Signal Feed

Executives and directors have to disclose every open-market stock purchase within two business days, on SEC Form 4. Most of that signal is buried in raw filings nobody reads. This pulls it straight from EDGAR for the tickers you care about, keeps only real cash purchases (and sales, if you want them), and flags when more than one insider is buying the same stock at once — the pattern that's historically the loudest insider signal there is.

What it does

1. Resolves each ticker to its SEC CIK number.
2. Pulls Form 4 filings from the lookback window you set.
3. Parses each filing's transactions directly from SEC's XML, no third-party data reseller in between.
4. Keeps open-market purchases (code P) by default; sales (code S) are opt-in. Grants, option exercises, and gifts are dropped — they're real filings, but not a conviction signal.
5. Scores each ticker 0-100 on buying conviction: how many distinct insiders bought, how much they spent, and whether an officer, director, or 10%+ owner was among them.
6. Flags clusterBuying: true once enough distinct insiders bought the same ticker inside your window.
7. Drops anything under your minimum transaction value before billing.

Output

Field	Notes
ticker, issuerName	What was traded
ownerName, role	Who traded it — title if they're an officer, plus director / 10%+ owner flags
kind, transactionCode	purchase (P) or sale (S)
transactionDate, shares, pricePerShare, transactionValue	The trade itself
sharesOwnedAfter	Their resulting stake
distinctBuyers, totalBuyValue, clusterBuying, qualityScore	Ticker-level signal, repeated on every row for that ticker
filingUrl	Link to the source Form 4, for verification

Input

Only tickers is required.

{
  "tickers": ["AAPL", "TSLA"],
  "lookbackDays": 90,
  "minTransactionValue": 25000,
  "minClusterBuyers": 2,
  "includeSales": false
}

A note on SEC access

SEC's fair-access policy asks automated tools to identify a real contact in the User-Agent header. Set requesterEmail to your own address — it's used only in that header, on every request this run makes, and nowhere else.

Pricing

Pay per event. You're billed for qualifying transactions returned and for cluster-buying alerts, not for the SEC lookups themselves.