Live SEC Filings
WSwss://socket.vantafin.com/v1/stocks
Subscribe to live SEC EDGAR filings over the same WebSocket connection. Use channel F.{ticker} for a specific ticker (e.g. F.AAPL) or F.* for every new filing market-wide. Each message is pushed the moment a filing is indexed and carries metadata only - ticker, company, CIK, form type, filed date, accession number, EDGAR base URL, and the Vantafin filing id. Fetch the full filing document and exhibits via REST /filings/by-id/{id}. Like news, filings stream around the clock.
Use cases
- Real-time filing alerts for
8-K,10-K,10-Qand other form types - Event-driven workflows when a watchlist company files with the SEC
- Compliance and research feeds without polling the REST filings API
- Triggering document retrieval pipelines as filings are published
Subscribe
Send a subscribe message after connecting. Use F.{ticker} (e.g. F.AAPL) for a single symbol or F.* for every symbol.
{
"action": "subscribe",
"params": "F.AAPL"
}Message fields
| Field | Type | Description |
|---|---|---|
| type | string | Always 'filing'. |
| ticker | string | Ticker that filed. |
| company | string | Company or fund name. |
| cik | string | SEC Central Index Key. |
| form | string | SEC form type, e.g. 10-K, 10-Q, 8-K. |
| date | string | Filing timestamp (ISO 8601). |
| accession | string | SEC accession number. |
| edgar_base | string | Base URL for the filing on SEC EDGAR. |
| id | string | Vantafin filing id (same as REST /filings/by-id/{id}). |
from vantafin import WebSocketClient
ws = WebSocketClient("vf-live-your_api_key")
ws.connect()
ws.subscribe(["F.AAPL"])
for message in ws:
print(message){
"type": "filing",
"ticker": "AAPL",
"company": "Apple Inc.",
"cik": "0000320193",
"form": "8-K",
"date": "2026-06-16T14:30:00Z",
"accession": "0000320193-26-000045",
"edgar_base": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000045",
"id": "0000320193_000032019326000045"
}