🏛️ InsiderWhale AI — SEC Insider Trading & Whale Alerts (Form 4)

Real-time SEC EDGAR insider trading scraper. Track C-suite open-market stock purchases, detect high-conviction "Cluster Buys", and dispatch instant Discord & Telegram webhook alerts.

---

🚀 The Edge: Why Follow Insider "Smart Money"?

Corporate executives and board members know more about their company’s financial trajectory, product pipelines, and earnings health than any outside analyst.

When an executive sells stock, it might simply be for personal liquidity, taxes, or diversification. But when a CEO, CFO, or Director buys stock on the open market with their own personal cash, there is only one reason: they believe the stock is undervalued and going up.

Dozens of academic papers and quantitative hedge funds have proven that insider open-market purchases (SEC Form 4 Code P) generate statistically significant forward alpha, particularly when multiple executives buy in tandem ("Cluster Buys").

InsiderWhale AI gives retail traders, hedge funds, fintech apps, and trading communities direct access to this raw institutional intelligence without paying thousands of dollars for Bloomberg terminals or enterprise feeds.

---

✨ Key Features

Feature	Description
⚡ Official Real-Time SEC Stream	Scrapes official SEC EDGAR Form 4 filings directly as they are accepted by the SEC.
🏷️ Transaction Code Classification	Isolates pure Open Market Purchases (P) from routine stock awards (A), option exercises (M), and open sales (S).
🔥 "Cluster Buy" Detection	Automatically flags tickers where 2 or more distinct corporate insiders are buying shares in the same window.
👑 C-Suite & Executive Recognition	Detects CEO, CFO, COO, President, and Board Director titles and separates them from general employees.
💰 Dollar Value Thresholds	Filter out minor trades and focus strictly on Whale Trades (e.g. trades > $50k, $100k, or $1,000,000+).
🎯 Target Ticker Watchlist	Monitor the entire stock market or supply a custom watchlist of tickers (e.g., NVDA, TSLA, PLTR, AAPL).
🔔 Discord & Telegram Webhooks	Automatically broadcast real-time formatted alert cards directly to your Discord trading channels or Telegram groups.
🛡️ Zero Proxy Surcharges	Powered by the official SEC EDGAR API—100% legal, reliable, and free of expensive residential proxy costs.

---

📥 Input Parameters

Parameter	Type	Default	Description
filingCount	integer	50	Number of recent Form 4 filings to scan from the live SEC EDGAR stream (10 to 200).
transactionTypes	array	["P", "S"]	Transaction codes to extract: P (Open Market Purchase), S (Open Market Sale), A (Grant/Award), M (Option Exercise), or ALL.
minTransactionValueUsd	number	0	Minimum trade value in USD (e.g. 50000 for $50k+ trades).
onlyClusterBuys	boolean	false	When enabled, only outputs companies with 2+ insiders buying in the batch.
onlyCeoCfo	boolean	false	When enabled, only outputs trades by CEOs, CFOs, or Presidents.
tickerWatchlist	string	""	Comma-separated list of tickers to monitor (e.g. NVDA, TSLA, PLTR). Leave empty to scan all US stocks.
discordWebhookUrl	string	""	Optional Discord Webhook URL for instant embed alert cards.
telegramBotToken	string	""	Optional Telegram Bot Token (from @BotFather) for mobile push alerts.
telegramChatId	string	""	Optional Telegram Chat / Channel ID.

---

📤 Sample Output

Each output dataset record represents a verified, structured insider trade:

{
  "companyName": "NVIDIA CORP",
  "ticker": "NVDA",
  "companyCik": "0001045810",
  "insiderName": "Huang Jen Hsun",
  "insiderTitle": "President and CEO",
  "isCeoCfo": true,
  "tradeType": "🛒 Open Market Purchase (Direct Buy)",
  "transactionCode": "P",
  "transactionDate": "2026-09-08",
  "securityTitle": "Common Stock",
  "shares": 25000,
  "pricePerShare": 115.50,
  "totalValueUsd": 2887500.00,
  "sharesOwnedFollowing": 78250000,
  "isClusterBuy": true,
  "clusterBuyCount": 3,
  "filingDate": "2026-09-09T18:15:00-04:00",
  "filingUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000045/0001045810-26-000045-index.htm",
  "scrapedAt": "2026-09-10T00:30:00.000Z"
}

---

💼 High-ROI Use Cases

1. Stock & Crypto Discord / Telegram Communities

Give your members exclusive real-time alerts whenever a Fortune 500 CEO buys millions of dollars of their own stock. Simply paste your channel's Discord webhook URL into the Actor input to automate 24/7 alerts.

2. Swing Traders & Retail Investors

Screen for high-conviction cluster buys where the CEO, CFO, and a Board Member all purchase shares in the same week—a proven signal of impending corporate catalysts.

3. FinTech Startups & Newsletter Authors

Build automated weekly newsletters ("Top 10 Insider Cluster Buys of the Week") or feed structured JSON directly into your proprietary investment dashboard.

4. Quantitative Hedge Funds & Signal Generation

Feed clean, machine-readable XML trade data into your backtesting algorithms without building and maintaining brittle custom SEC crawlers.

---

💰 Pay-Per-Event (PPE) Pricing

This Actor operates on transparent Pay-Per-Event pricing. You only pay for what you extract:

• Actor Start Event: $0.002 per run execution.
• Verified Insider Trade Item: $0.004 per structured transaction record.

Example: Scanning 50 filings and extracting 20 high-conviction trades costs just ~$0.08!