SEC EDGAR Disclosure Candidate Watch

Watch official SEC EDGAR submissions for source-linked disclosure candidates, 8-K item metadata, filing deltas, exhibit links, and portfolio reports without investment advice.

Legal, IR, corp-dev, and competitive intelligence teams use this actor to track source-linked SEC disclosure candidates without investment advice.

Store Quickstart

1. Start with the example input in store-input.example.json.
2. Keep dryRun=true for a sample row, then set dryRun=false only when the required source access is ready.
3. Review the output rows and billingEventName values before scheduling recurring runs.

Input Examples

{
  "issuers": [
    "MSFT"
  ],
  "formTypes": [
    "8-K",
    "10-K",
    "10-Q",
    "S-1"
  ],
  "daysBack": 90,
  "disclosureKeywords": [
    "customer agreement",
    "acquisition",
    "resignation",
    "cybersecurity",
    "regulatory"
  ],
  "secUserAgent": "",
  "generateReport": true,
  "emitUnchanged": false,
  "dryRun": true
}

{
  "issuers": [
    "NVDA"
  ],
  "formTypes": [
    "8-K",
    "10-K",
    "10-Q",
    "S-1"
  ],
  "daysBack": 90,
  "disclosureKeywords": [
    "customer agreement",
    "acquisition",
    "resignation",
    "cybersecurity",
    "regulatory"
  ],
  "secUserAgent": "",
  "generateReport": true,
  "emitUnchanged": false,
  "dryRun": true
}

{
  "issuers": [
    "MSFT"
  ],
  "formTypes": [
    "8-K"
  ],
  "daysBack": 90,
  "disclosureKeywords": [
    "customer agreement",
    "acquisition",
    "resignation",
    "cybersecurity",
    "regulatory"
  ],
  "secUserAgent": "your-company-edgar-watch/1.0 ops@yourcompany.com",
  "generateReport": true,
  "emitUnchanged": false,
  "dryRun": false
}

Sample Output

See docs/sample-output.json for a complete sample.

Output Fields

Every row includes:

• billingEventName for PAY_PER_EVENT charging
• sourceName, sourceUrl, retrievedAt, and sourceMethod
• authorizationBasis
• limitations and prohibitedInterpretations

Pricing

PAY_PER_EVENT is planned with a very small actor-start event and outcome-priced rows:

• sec-filing-detected: $0.01
• sec-disclosure-candidate-alert: $0.35
• sec-disclosure-report: $12

No-change runs must emit zero default dataset rows and zero billable events by default.

Compliance Guardrails

• Use official SEC EDGAR public APIs with a descriptive User-Agent.
• Do not provide investment advice, trading recommendations, legal materiality determinations, or market impact predictions.
• Stay within SEC fair-access request limits.

See Also

• apple-podcast-scraper for the current proven media-data winner.
• reports/revenue-summary.md for the April 2026 revenue baseline.
• reports/phase87-high-ev-implementation-latest.json for this Phase 8.7 launch gate summary.