2,780 stars · MIT · v5.61.1 (2026-10-06) · Track this in Scout
Reads United States company filings and their financial tables in Python, returning typed objects rather than raw documents.
▶Repo detailsthe review · specs · pros & cons · install
What it is
EdgarTools is a Python library over the Securities and Exchange Commission's EDGAR system. It covers annual and quarterly reports, current reports, insider-trading forms, institutional holdings disclosures and adviser registrations, and parses the structured financial data inside them rather than only downloading the files.
What it is good for. Anyone doing research on listed companies who is currently copying numbers out of a web page by hand, or paying for a data feed that repackages this same free source. The parsing is the whole value: downloading a filing is easy and turning its financial statements into a table is not.
- MIT, read from
LICENSE.txt, with a real copyright line: "Copyright (c) 2022-present Dwight Gunning". - A fast release cadence with real activity behind it: v5.61.1 on 6 October 2026, two releases that same day, and code on 8 October 2026.
- It understands the document types rather than treating every filing as a blob, so financial statements, Form 4 insider trades and 13F holdings all come back as structured objects.
- ⚠ The current release is a security release, so anything older should be updated. Version 5.61.1's own notes say it "raises dependency minimums past known vulnerabilities", and that the optional MCP server's HTTP mode now listens only on the local machine by default — which means earlier versions did not.
- ⚠ You must set an identity before anything works. EDGAR requires an email address with every request, so the first line of any script is
set_identity("your.name@example.com"). Leave it out and the requests are refused. - United States filings only, the published Python minimum (3.10) lives on the package page rather than in the README, and the optional artificial-intelligence extras bring a much larger dependency set with them. No memory or disk figures are published.
- sec-edgar/sec-edgar
Bulk-downloads the same filings and leaves all parsing to the caller, so there is no financial-statement layer.
Track this in Scout - jadchaar/sec-edgar-downloader
Deliberately narrow: saves filings to disk by ticker, company number or form type, with no extraction of the data inside them.
Track this in Scout - lefterisloukas/edgar-crawler
Research-oriented, pulling named sections such as the risk-factors item into JSON for text analysis rather than offering a filings interface.
Track this in Scout
python3 -m venv venv source venv/bin/activate # on Windows: venv\Scripts\activate pip install edgartools
