SEC Filing Alerts — Watchlist Feed with 8-K Classification & Form 4 Digests

Point it at a watchlist of tickers, get a clean structured feed of every new SEC filing that matters — on a schedule. 8-K material events come back with each item already classified to its plain-English label; Form 4 insider trades come back digested (who traded, buy or sell, how many shares, at what price, total dollar value, and shares held after). Straight from the free official SEC EDGAR API: no key, no scraping, no personal data — US public record.

Who this is for

• Investors & analysts — one feed for a whole portfolio: earnings, leadership changes, insider buys and sells.
• Fintech & AI agents — typed JSON per filing, ready to drop into a model or database.
• Journalists & researchers — insider activity and material events across many companies at once.

How to use it (zero setup)

1. Set your watchlist — stock tickers (AAPL, TSLA, NVDA) and/or SEC CIK numbers. Tickers are resolved automatically via the official SEC map.
2. Pick the form types to watch (default 8-K + 4). Add 13D/13G for ownership stakes, 10-Q/10-K for periodic reports.
3. Run it on a schedule with sinceDays matching the interval (default 7 = weekly).

A run has no memory of the previous run, so the look-back window is the dedup model: schedule at an interval no longer than sinceDays, and dedup downstream on accessionNumber (globally unique per filing).

Example input

{
    "watchlist": ["AAPL", "TSLA"],
    "formTypes": ["8-K", "4"],
    "sinceDays": 30,
    "maxItems": 100
}

Example output — 8-K with classified items

{
    "ticker": "TSLA",
    "cik": "0001318605",
    "companyName": "Tesla, Inc.",
    "formType": "8-K",
    "filingDate": "2026-07-02",
    "reportDate": "2026-07-02",
    "accessionNumber": "0001628280-26-046717",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/1318605/000162828026046717/0001628280-26-046717-index.htm",
    "itemsWithLabels": [
        { "code": "2.02", "label": "Results of Operations and Financial Condition" },
        { "code": "9.01", "label": "Financial Statements and Exhibits" }
    ],
    "insiderDigest": null
}

Example output — Form 4 insider-trade digest

{
    "ticker": "TSLA",
    "cik": "0001318605",
    "companyName": "Tesla, Inc.",
    "formType": "4",
    "filingDate": "2026-06-17",
    "accessionNumber": "0001104659-26-075213",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/1318605/000110465926075213/0001104659-26-075213-index.htm",
    "insiderDigest": {
        "insiderName": "Musk Elon",
        "roles": ["Director", "Officer", "10% Owner"],
        "officerTitle": "CEO",
        "transactions": [
            { "security": "Common Stock", "date": "2026-06-16", "code": "M", "action": "Acquired", "shares": 303960630, "pricePerShare": 23.34, "value": 7094441104, "sharesOwnedAfter": 727704534, "ownership": "Direct" },
            { "security": "Common Stock", "date": "2026-06-16", "code": "F", "action": "Disposed", "shares": 17531857, "pricePerShare": 404.66, "value": 7094441254, "sharesOwnedAfter": 710172677, "ownership": "Direct" }
        ],
        "summary": { "transactionCount": 2, "netShares": 286428773, "totalAcquiredValue": 7094441104, "totalDisposedValue": 7094441254, "codes": ["M", "F"] }
    }
}

If a Form 4's XML can't be fetched or parsed, that filing is dropped and not charged (the digest is the value over the free SEC feed). The run continues for the rest of the watchlist.

Why not just use SEC's free RSS feeds?

SEC publishes a free per-company Atom feed (browse-edgar?...&output=atom) — fine for raw filing notifications. This actor adds what it doesn't:

• Form 4 dollar digests. The RSS entry is just a link to the filing; this actor fetches and parses the ownership XML into insider name, role, transaction code, shares, price, dollar value, and post-transaction holdings.
• One call for a whole watchlist. RSS is one feed per company — 20 names means 20 feeds you schedule and merge yourself. Here it's a single watchlist array in, one merged and deduped dataset out.
• Structured JSON, not HTML. The RSS <summary> spells out 8-K item labels, but as an HTML string you have to scrape. This actor returns itemsWithLabels as typed {code, label} pairs — built for databases and AI agents, not eyeballs.

In short: RSS notifies; this actor classifies, digests, and merges.

Pricing

Pay per event: one filing-alert per filing delivered. maxItems caps the count, so you cap the spend. Unresolved watchlist entries (unknown ticker, missing CIK) and filings outside the window are never charged. No API key or subscription — the SEC source is free.

Data source & fair use

SEC EDGAR — the official US securities-filing system, public record by law. This actor uses the documented free JSON/XML endpoints with an identifying User-Agent and stays within SEC's 10 requests/second fair-access limit. It is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. Filings are public data; anything you build on them is your responsibility.

---

Found this useful? A review on the actor page helps other people find it — and tells me what to build next. Hit a problem? Open an issue and I'll fix it fast.

Telemetry

Each run records one anonymous telemetry event to the developer's own storage: a salted hash of the caller account ID (never the raw ID), the run origin (e.g. web console vs API), and a timestamp. No inputs, results, or personal data are collected - this only measures adoption (distinct and returning users).