SEC EDGAR Filing Event Stream

Structured SEC filings, not raw text. 8-K item codes decoded to plain-English events with a materiality tier, tickers resolved, and Form 4 insider trades parsed to actual dollar value.

No API key. No proxy. No login. Runs straight off SEC's official EDGAR endpoints.

---

Why this instead of a generic EDGAR scraper

Most EDGAR scrapers hand you items: ["5.02"] and a URL, and leave the interpretation to you. This one does the work:

	Generic EDGAR scraper	This Actor
8-K items	["1.01","5.02"]	Decoded labels + materiality tier 1–3
Company on Form 4	the insider's personal name	the issuer, with the reporter split out
Insider trades	link to an XML file	parsed transactions with USD value and net buy/sell
Duplicate rows	one row per matched document	collapsed to one row per filing
Ticker	not provided	parsed out of EDGAR's combined display string

That last row matters more than it sounds. EDGAR full-text search returns a hit per document, so a single 8-K with four exhibits gives you four near-identical rows. This Actor collapses them and rolls the matched documents into matched_documents.

---

What you can pull

• Every 8-K filed in a window, filtered to only the market-moving ones. Set minMateriality: 3 and you get M&A, earnings releases, CEO departures, going-concern warnings, auditor changes, delisting notices, and material cybersecurity incidents — and nothing about code-of-ethics amendments.
• Insider buying and selling with dollar amounts. Set formTypes: ["4"] and includeForm4Details: true.
• Full-text search across filing bodies. "material weakness", "going concern", "strategic alternatives", "restatement" — any phrase, across every form type since 2001.
• Everything a specific company filed. Pass ciks and leave the query empty.

---

Example input

Market-moving 8-Ks over the last quarter:

{
  "query": "",
  "formTypes": ["8-K"],
  "dateFrom": "2026-05-01",
  "dateTo": "2026-08-08",
  "minMateriality": 3,
  "maxItems": 500
}

Insider open-market activity with dollar values:

{
  "formTypes": ["4"],
  "dateFrom": "2026-08-01",
  "dateTo": "2026-08-08",
  "includeForm4Details": true,
  "maxItems": 200
}

---

Example output

An 8-K:

{
  "accession_number": "0001477932-26-004518",
  "form_type": "8-K",
  "filed_date": "2026-07-27",
  "company_name": "Oyocar Group Inc.",
  "ticker": "OYCG",
  "cik": "0001994582",
  "items": [
    { "code": "1.01", "label": "Entry into a Material Definitive Agreement", "materiality": 3 },
    { "code": "5.01", "label": "Changes in Control of Registrant", "materiality": 3 },
    { "code": "5.02", "label": "Departure or Election of Directors or Principal Officers", "materiality": 3 },
    { "code": "9.01", "label": "Financial Statements and Exhibits", "materiality": 1 }
  ],
  "materiality": 3,
  "sic_code": "5500",
  "state_of_incorporation": "NV",
  "matched_documents": [
    { "type": "EX-10.1", "description": "LETTER OF INTENT", "url": "https://www.sec.gov/Archives/..." }
  ],
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1994582/000147793226004518/0001477932-26-004518-index.htm"
}

A Form 4 with includeForm4Details: true:

{
  "form_type": "4",
  "company_name": "Kinder Morgan, Inc.",
  "ticker": "KMI",
  "reporting_owner": { "company_name": "Garthwaite Michael P.", "cik": "0001725husk" },
  "insider_transaction": {
    "reporter_name": "Garthwaite Michael P.",
    "officer_title": "VP (Pres., Products Pipelines)",
    "reporter_roles": ["Officer"],
    "transactions": [
      {
        "date": "2026-08-04",
        "code": "S",
        "code_label": "Open market sale",
        "direction": "SELL",
        "shares": 1550,
        "price_per_share": 32.5162,
        "value_usd": 50400.11,
        "shares_owned_after": 41893
      }
    ],
    "total_open_market_sell_usd": 50400.11,
    "net_open_market_usd": -50400.11
  }
}

---

Materiality tiers

Tier	Meaning	Example items
3	Typically price-moving	1.01 material agreement · 1.03 bankruptcy · 1.05 cyber incident · 2.01 M&A completion · 2.02 earnings · 2.06 impairment · 3.01 delisting · 4.02 non-reliance/restatement · 5.01 control change · 5.02 officer departure
2	Often material	2.03 new debt · 2.05 restructuring costs · 3.02 unregistered equity sales · 7.01 Reg FD
1	Routine / procedural	5.03 bylaw amendments · 5.05 code of ethics · 5.07 shareholder vote results · 9.01 exhibits

Tiers are a screening heuristic based on how these item types usually trade, not investment advice.

---

Pricing

Pay per event, no subscription:

Event	Price
filing — one unique filing returned	$0.02
form4-detail — insider XML fetched and parsed	$0.03

maxItems is your hard cost ceiling. Filtering by materiality happens before billing, so you are not charged for filings you filtered out.

---

Limits and honest caveats

• EDGAR full-text search covers 2001 to present. Older filings are not reachable through this route.
• EDGAR caps deep paging at roughly 10,000 documents per query. If your filters match more, the Actor logs a warning — narrow the date range and run again in slices.
• Materiality tiers are heuristics. A tier-1 "Other Events" 8-K occasionally contains the most important news of the year. Filter with that in mind.
• Form 4 dollar values are only computed where the filing reports a price. Grants and awards (code A) usually report $0.00, so they contribute shares but no dollar value — which is correct, not a bug.
• The Actor honours SEC's fair-access policy: declared User-Agent, under 10 requests/second, automatic backoff on 429.

Data and privacy

All data comes from SEC EDGAR, a US federal public disclosure system. Form 4 reporters are corporate officers, directors, and 10% owners whose identity disclosure is mandated by Section 16 of the Securities Exchange Act. This Actor does not extract the residential addresses that EDGAR publishes alongside them.

Who uses this

Event-driven and quantitative trading desks · corporate development and M&A teams · competitive intelligence · compliance and risk monitoring · financial journalists · AI agents that need structured filing events rather than PDFs.