SEC-Edgar: Download SEC Filings Easily
Unlock the power of the SEC's EDGAR database with SEC-Edgar, an open-source Python library. This project simplifies the often cumbersome process of downloading periodic reports, filings, and forms for individual companies or even multiple entities simultaneously. Whether you're a financial analyst, student, or researcher, SEC-Edgar provides a streamlined approach to accessing crucial financial data. Learn how to install and utilize this valuable tool to fetch filings with just a single command, saving you significant time and effort in your data collection endeavors.
For anyone needing to access financial data from the U.S. Securities and Exchange Commission (SEC), navigating the EDGAR database can be a daunting task. However, the open-source project sec-edgar aims to drastically simplify this process.
What is SEC-Edgar?
SEC-Edgar is a Python library designed to empower users to download periodic reports, filings, and forms from the EDGAR database with remarkable ease. Whether you need the latest 10-Q for a single company or historical filings for multiple corporations, this tool offers a streamlined solution.
Key Features and Functionality:
- Single Command Downloads: The core utility of SEC-Edgar lies in its ability to fetch filings using a simple command. This eliminates the need for manual searching and downloading.
- Company-Specific Filings: Easily retrieve filings for a particular company by its ticker symbol or CIK (Central Index Key).
- Multiple Company Support: Download filings for several companies simultaneously, making comparative analysis more efficient.
- Daily Filings: Access filings that were submitted on a specific date.
- Broad Filing Type Support: The library supports a wide array of filing types, and users are encouraged to submit requests for any missing types.
Getting Started with SEC-Edgar:
Installation is straightforward, accessible via pip:
pip install secedgar
Alternatively, you can clone the repository and install it locally:
git clone https://github.com/sec-edgar/sec-edgar.git
cd sec-edgar
python setup.py install
For users of Jupyter Notebooks, ensuring asynchronous operations run smoothly requires the nest-asyncio package:
import nest_asyncio
nest_asyncio.apply()
Example Usage:
To download all 10-Q filings for Apple (ticker 'aapl'):
from secedgar import filings, FilingType
my_filings = filings(cik_lookup="aapl",
filing_type=FilingType.FILING_10Q,
user_agent="Your name (your email)")
my_filings.save('/path/to/dir')
Contribution and Community:
With over 1.3k stars and 319 forks on GitHub, SEC-Edgar is a growing and active open-source project. The project welcomes contributions, and its developers are responsive to issues and feature requests. The project is licensed under the permissive Apache-2.0 license, encouraging widespread adoption and modification.
Whether you're a data scientist, financial analyst, or student interested in market trends, SEC-Edgar offers a robust and accessible way to gather essential financial documents. Explore the official documentation for more details on its capabilities and how to contribute.