SEC EDGAR Filing Delta Monitor

Monitor official SEC EDGAR filings for a ticker/CIK watchlist and return only new or changed filings in automation-ready JSON.

What it does

• Resolves tickers through the official SEC company ticker index.
• Fetches recent filing metadata from the official SEC submissions JSON endpoint.
• Filters by form type, filing date window, amendments, company/query text, accession number, and keywords.
• Computes stable new / changed deltas using CIK + accession number.
• Writes normalized filing alerts to the default dataset.
• Writes RUN_SUMMARY, WEBHOOK_PAYLOAD, and OUTPUT to the default key-value store.

What makes it different

This is not another broad EDGAR extraction suite. It is similar to SEC EDGAR scrapers, but different because it is a stateful filing delta monitor for watchlists with compact automation/webhook outputs.

V1 intentionally does not include XBRL extraction, 13F holdings parsing, insider-trade detail parsing, full-text search, primary-document text extraction, AI summaries, or investment advice.

Recommended use

Schedule the Actor for a watchlist:

{
  "mode": "delta",
  "changeMode": "new_and_changed",
  "stateKey": "portfolio-watchlist",
  "tickers": ["AAPL", "MSFT", "NVDA"],
  "filingTypes": ["8-K", "10-Q", "10-K", "4"],
  "relativeDateFromDays": 30,
  "maxItems": 100,
  "includeAmendments": false,
  "webhookMode": "summary",
  "userAgentEmail": "you@example.com"
}

Use a separate stateKey for each distinct watchlist or alert workflow.

Output fields

• change_type
• ticker
• company_name
• cik
• filing_type
• accession_number
• filed_at
• accepted_at
• reporting_period
• items
• primary_document_url
• filing_detail_url
• source_url
• stable_id
• state_key
• matched_keywords
• matched_fields

Fair access

The Actor declares a User-Agent on SEC requests. Use a real contact email in userAgentEmail, keep schedules reasonable, and avoid unnecessarily large watchlists.

Disclaimer

This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission. It uses public SEC EDGAR data.