# SEC EDGAR Filings | 8-K Decoded + Form 4 Insider $ (`adored_maze/sec-filing-event-stream`) Actor

Structured SEC filing feed. 8-K item codes decoded to plain-English events with a materiality tier, tickers resolved, Form 4 insider trades parsed to dollar value. No API key, no proxy.

- **URL**: https://apify.com/adored\_maze/sec-filing-event-stream.md
- **Developed by:** [Bizking Jang](https://apify.com/adored_maze) (community)
- **Categories:** Developer tools, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 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:

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

Insider open-market activity with dollar values:

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

***

### Example output

An 8-K:

```json
{
  "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`:

```json
{
  "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.

# Actor input Schema

## `query` (type: `string`):

Words or exact phrases to find inside filing documents. Wrap phrases in double quotes, e.g. "definitive agreement" or "material weakness". Leave empty to return every filing matching your other filters.

## `formTypes` (type: `array`):

EDGAR form types to include, e.g. 8-K, 10-K, 10-Q, 4, SC 13D, S-1, DEF 14A. Leave empty for all forms.

## `ciks` (type: `array`):

Limit to specific companies by CIK number. Accepts padded or unpadded form (320193 or 0000320193). Leave empty for all companies.

## `dateFrom` (type: `string`):

Earliest filing date, YYYY-MM-DD. EDGAR full-text search covers 2001 onward.

## `dateTo` (type: `string`):

Latest filing date, YYYY-MM-DD.

## `minMateriality` (type: `integer`):

Filter 8-K filings by how price-relevant their items usually are. 3 = typically market-moving (M\&A, earnings, CEO departure, restatement, cyber incident). 2 = often material. 1 = routine. 0 = no filter.

## `includeForm4Details` (type: `boolean`):

For Form 4 filings, fetch and parse the ownership XML to extract insider name, role, each transaction, and its dollar value. Adds one request per filing and is billed as a separate event.

## `maxItems` (type: `integer`):

Stop after this many unique filings. Billing is per filing returned, so this is your cost ceiling.

## Actor input object example

```json
{
  "query": "\"definitive agreement\"",
  "formTypes": [
    "8-K"
  ],
  "ciks": [],
  "minMateriality": 0,
  "includeForm4Details": false,
  "maxItems": 100
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "\"definitive agreement\""
};

// Run the Actor and wait for it to finish
const run = await client.actor("adored_maze/sec-filing-event-stream").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "query": "\"definitive agreement\"" }

# Run the Actor and wait for it to finish
run = client.actor("adored_maze/sec-filing-event-stream").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "\\"definitive agreement\\""
}' |
apify call adored_maze/sec-filing-event-stream --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,adored_maze/sec-filing-event-stream"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vd1Kkqrtw7FcWLCyW/builds/yy0mDO51FpUJwehve/openapi.json