SEC Form 4 Insider Trading Scraper

Scrape insider transactions from SEC Form 4 filings — the disclosures US officers, directors and 10% owners must file when they trade their own company's stock.

The difference from a raw filings dump: this Actor classifies the signal apart from the noise. Around nine in ten Form 4 rows are compensation mechanics — option grants, vesting, exercises, shares withheld for tax. Only a minority are an insider deciding to buy or sell on the open market with their own money. One switch, onlyBuys, gives you just those.

No API key, no account.

What you get

One row per transaction, not per filing:

Field	Description
insiderName, insiderCik, insiderState	Who traded
isOfficer, isDirector, isTenPercentOwner, officerTitle	Their role and job title
issuerName, ticker, issuerCik	The company
transactionDate, transactionCode, transactionLabel	When, and what kind of transaction
isOpenMarket, direction	Whether it was a real market decision, and which way
shares, pricePerShare, transactionValueUsd	Size, price and computed value
sharesOwnedAfter, ownership	Holdings after the trade, direct or indirect
securityType, securityTitle	Common stock, options, warrants
accession, sourceUrl	The filing this came from

Use cases

• Insider-buying signals — onlyBuys: true plus minTransactionValueUsd surfaces conviction purchases by executives, the subset most studied as a predictive signal.
• Cluster detection — several officers of the same company buying in the same window, visible once grants are filtered out.
• Executive sale monitoring — track disposals ahead of events, filtered to code S so vesting does not pollute the series.
• Fintech and research products — a clean transaction table to load into a database or model, instead of raw XML.
• Compliance and IR teams — monitor what your own insiders and your peers are filing.

Input

Option	Description
startDate / endDate	Filing-date window. Defaults to the last seven days.
tickers	Limit to specific symbols.
onlyBuys	Code P only — open-market purchases.
onlyOpenMarket	Codes P and S, dropping compensation activity.
transactionCodes	Exact codes: P, S, A, M, F, G, D.
insiderRoles	Officer, director, 10% owner.
minTransactionValueUsd, minShares	Size thresholds.
includeDerivatives	Options and warrants, off by default.
maxItems, maxFilings	Run size and how many filings to open.

Example: significant insider buys in the last week

{
  "onlyBuys": true,
  "minTransactionValueUsd": 100000,
  "insiderRoles": ["officer", "director"],
  "maxFilings": 2000
}

Example: everything two companies filed this quarter

{
  "tickers": ["AAPL", "NVDA"],
  "startDate": "2026-07-01",
  "endDate": "2026-09-30",
  "includeDerivatives": true
}

Transaction codes

Code	Meaning	Open market
P	Purchase	yes
S	Sale	yes
A	Grant or award	no
M	Option exercise	no
F	Shares withheld for tax	no
D	Disposition to issuer	no
G	Gift	no

Grants and exercises usually report no price, so transactionValueUsd is left null rather than filled with a misleading zero — and a value filter therefore excludes them.

How the run works

Filings are enumerated through EDGAR full-text search, then each filing's XML is fetched and parsed. Every request carries a descriptive User-Agent and the run is throttled to stay inside the SEC's published rate limit, so a wide date range with a narrow filter needs a higher maxFilings and takes longer. Around 500 Form 4 filings arrive on a typical business day.

Privacy note

Form 4 discloses the filer's home address. This Actor keeps only the state and never emits the street address, so the output stays useful for analysis without becoming a directory of private addresses.

Pricing

Billed per transaction delivered. Filings that are read but produce no matching transaction, and duplicates, are not charged.