Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Real-Time SEC Filing Stream API

Get SEC filings delivered to your application the moment they appear on EDGAR. Datastream monitors the EDGAR full-text feed continuously and pushes new filings through WebSocket connections and webhook callbacks with sub-minute latency.

Capabilities

WebSocket streaming

Open a persistent connection and receive filings as they land. Filter by form type, ticker, CIK, or SIC code.

Webhook callbacks

Register an endpoint and Datastream will POST structured filing data to your server with automatic retries and HMAC signing.

Sub-minute latency

Filings are detected, parsed, and dispatched within 60 seconds of appearing on EDGAR — often faster.

Structured payloads

Every event includes parsed metadata: accession number, form type, filer CIK, company name, filed date, and direct document URLs.

Quick start

Subscribe to real-time 10-K and 10-Q filings via webhook:
curl -X POST -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/sec",
    "forms": ["10-K", "10-Q"],
    "secret": "your-hmac-secret"
  }' \
  "https://api.secapi.ai/v1/webhook_endpoints"
{
  "webhook_id": "wh_abc123",
  "status": "active",
  "forms": ["10-K", "10-Q"],
  "created_at": "2025-03-15T10:30:00Z"
}
Get the latest filings via polling (REST fallback):
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/filings/latest?form=10-K&limit=5"

Use cases

Earnings release monitoring

Detect 8-K filings with Item 2.02 (Results of Operations) the moment they appear. Trigger downstream analysis pipelines or alert traders before the news hits terminals.

Compliance surveillance

Financial institutions can monitor filings from counterparties, portfolio companies, and regulated entities in real time without polling EDGAR.

AI-powered filing analysis

Pipe real-time filing events into LLM workflows to generate instant summaries, risk assessments, or structured extractions as filings land.

API endpoints

EndpointDescription
POST /v1/webhook_endpointsRegister a webhook for filing events
GET /v1/webhook_endpointsList active webhooks
POST /v1/webhook_endpoints/:webhook_id/rotate_secretRotate the HMAC signing secret
GET /v1/webhook_endpoints/:webhook_id/deliveriesInspect delivery history
GET /v1/filings/latestPoll latest filings (REST fallback)
WSS /v1/stream/wsWebSocket connection for real-time streaming

Why Datastream for real-time filings

FeatureDatastreamRaw EDGARSEC-API.ioQuiver Quant
WebSocket streamingYesNoNoNo
Webhook with HMAC signingYesNoYesNo
Sub-minute latencyYesN/A (polling)~5 min~15 min
Form type filteringYesNoYesLimited
Structured JSON payloadsYesNo (raw index)YesPartial
Python + JS SDKsYesNoNoNo

Get started

Get your API key

Start streaming SEC filings in under 60 seconds. 250 free API calls per month.