SEC-Edgar: Download SEC Filings Easily

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.