Check the Setup
- Python 3.10 or newer
- A notebook environment such as Jupyter or Google Colab
- A descriptive application name and contact address for the User-Agent header
Real-time public-company filing histories and structured financial facts for building disclosure alerts, research tools, and company monitors.
Report a ProblemFrom Source to Product Signal
EDGAR provides company submission histories and standardized XBRL facts without an API key. Start with one company's recent filings and identify it by its zero-padded CIK. Filing forms, amendments, reporting periods, units, and company-specific taxonomy extensions must be interpreted before records are compared.
Install the packages, then run the notebook cell.
python -m pip install pandas requests
import pandas as pd
import requests
headers = {
"User-Agent": "TrilemmaDataGuide/1.0 contact@trilemma.foundation"
}
response = requests.get(
"https://data.sec.gov/submissions/CIK0000320193.json",
headers=headers,
timeout=30,
)
response.raise_for_status()
payload = response.json()
filings = pd.DataFrame(payload["filings"]["recent"])
print(filings[["filingDate", "form", "accessionNumber", "primaryDocument"]].head())Test a Useful Signal
Determine whether recent 8-K, 10-Q, and 10-K filings can power a timely company-disclosure alert.
U.S. Securities and Exchange Commission is a government source. Last verified 2026-08-11. Temporal coverage: 1994-present; structured XBRL primarily 2009-present.