# SEC 8-K Event Monitor — Material Filing Alerts (`nexgendata/sec-8k-event-monitor`) Actor - **URL**: https://apify.com/nexgendata/sec-8k-event-monitor.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $250.00 / 1,000 filing alerts 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 8-K Event Monitor — Material Filing Alerts Monitor recent SEC 8-K filings and receive alerts when new material events appear. This Actor watches issuers or event types, tags each filing by 8-K item code, snapshots seen accession numbers, and emits only new filings in delta mode. ### What it does On each run it pulls **recent** 8-K filings using NexGenData's owned `sec-form-8k-material-events-scraper`, tags each filing by 8-K item code and a plain-English event label, records the accession numbers it has seen, and in delta mode emits only filings that are new since the last run. Schedule it and you only ever see new filings. It monitors recent filings on a rolling window — it is not a full real-time institutional feed, and it does not provide investment advice. ### Who it's for Equity research, investor relations, credit and counterparty risk, event-driven funds, and corporate-development teams that want a lightweight recurring 8-K watch. ### Recommended setup **Run once in `full` mode to baseline, then schedule daily `delta` runs.** The first delta run per watch query records a baseline and emits nothing (expected); after that you get only new filings. ### Inputs | Field | Default | Notes | |---|---|---| | `tickers` | `[]` | Only alert on these issuer tickers; empty = all issuers in the window | | `item_codes` | `[]` | Only alert on these 8-K item codes; empty = all events | | `lookback_days` | `3` | How many days back to scan each run | | `mode` | `delta` | `delta` (new only) or `full` (all in window) | | `max_filings` | `500` | Safety cap per run | | `include_raw` | `false` | Attach the raw source filing record | Common item codes: `1.01` material agreement (M&A/contract), `1.05` cybersecurity incident, `2.01` acquisition completed, `2.02` earnings, `4.01` auditor change, `4.02` restatement / non-reliance, `5.02` officer or director change. ### Outputs `accession_number, change_type, cik, ticker, company, form, filing_date, period_ending, items, event_labels, event_descriptions, state, sic, filing_url, matched_watch, detected_at` (plus `raw` when `include_raw` is true). `event_labels` is the plain-English label for each 8-K `items` code. ### Delta mode vs full mode - **full** — emits every filing in the window (each tagged) and records the snapshot. - **delta** — emits only filings whose accession number has not been seen before for this watch query. The first delta run records a baseline and emits nothing; later runs emit only new filings. ### Event labels Each 8-K item code is mapped to a readable label (e.g. `4.01` → "Change in auditor", `4.02` → "Non-reliance / restatement", `1.01` → "Material agreement (M&A/contract)", `5.02` → "Officer/director departure or election", `1.05` → "Cybersecurity incident"). ### Limitations This is an **alerting tool, not investment or legal advice**. It monitors **recent** 8-K filings on a rolling window via the owned source Actor; it is not a full real-time institutional coverage feed. Coverage and timing follow SEC EDGAR's publication of 8-K filings. Always confirm against the official filing before acting. # Actor input Schema ## `tickers` (type: `array`): Only alert on 8-K filings from these issuer tickers. Empty = monitor all issuers in the window. ## `item_codes` (type: `array`): Only alert on 8-K filings reporting these item codes, e.g. 4.01 (auditor change), 4.02 (restatement), 1.01 (material agreement), 5.02 (exec change). Empty = all events. ## `lookback_days` (type: `integer`): How many days back to scan for filings on each run. Use a small window for daily scheduled monitoring. ## `mode` (type: `string`): delta = only filings not seen since the last run (first run creates a baseline). full = all filings in the window. ## `max_filings` (type: `integer`): Safety cap on filings pulled from the source per run. ## `include_raw` (type: `boolean`): Attach the raw source filing record to each output row. ## Actor input object example ```json { "tickers": [], "item_codes": [], "lookback_days": 3, "mode": "delta", "max_filings": 500, "include_raw": false } ```` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/sec-8k-event-monitor").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("nexgendata/sec-8k-event-monitor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call nexgendata/sec-8k-event-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/sec-8k-event-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC 8-K Event Monitor — Material Filing Alerts", "version": "0.0", "x-build-id": "dqFarLEWLJHIHOlCM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~sec-8k-event-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-sec-8k-event-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~sec-8k-event-monitor/runs": { "post": { "operationId": "runs-sync-nexgendata-sec-8k-event-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~sec-8k-event-monitor/run-sync": { "post": { "operationId": "run-sync-nexgendata-sec-8k-event-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "tickers": { "title": "Watched tickers (optional)", "type": "array", "description": "Only alert on 8-K filings from these issuer tickers. Empty = monitor all issuers in the window.", "default": [], "items": { "type": "string" } }, "item_codes": { "title": "Event item codes (optional)", "type": "array", "description": "Only alert on 8-K filings reporting these item codes, e.g. 4.01 (auditor change), 4.02 (restatement), 1.01 (material agreement), 5.02 (exec change). Empty = all events.", "default": [], "items": { "type": "string" } }, "lookback_days": { "title": "Lookback window (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "How many days back to scan for filings on each run. Use a small window for daily scheduled monitoring.", "default": 3 }, "mode": { "title": "Mode", "enum": [ "full", "delta" ], "type": "string", "description": "delta = only filings not seen since the last run (first run creates a baseline). full = all filings in the window.", "default": "delta" }, "max_filings": { "title": "Max filings per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on filings pulled from the source per run.", "default": 500 }, "include_raw": { "title": "Include raw record", "type": "boolean", "description": "Attach the raw source filing record to each output row.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```