Skip to main content

Download SEC filings from the EDGAR database using Python.

Project description

Build Status Coverage Status PyPI Version Supported Python Versions License Code Style: Black

sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. Searches can be conducted either by stock ticker or Central Index Key (CIK). You can use the SEC CIK lookup tool if you cannot find an appropriate ticker.

Quick Start

Installation

Install and update this package using pip or pipenv:

$ pip install -U sec-edgar-downloader

Example Usage

from sec_edgar_downloader import Downloader

# Initialize a downloader instance.
# If no argument is passed to the constructor, the package
# will attempt to locate the user's downloads folder.
dl = Downloader("/path/to/valid/save/location")

# Get all 8-K filings for Apple (ticker: AAPL)
dl.get_8k_filings("AAPL")

# Get all 8-K filings for Apple, including filing amends (8-K/A)
dl.get_8k_filings("AAPL", include_amends=True)

# Get all 8-K filings for Apple before March 25, 2017
# Note: before_date string must be in the form "YYYYMMDD"
dl.get_8k_filings("AAPL", before_date="20170325")

# Get the past 5 8-K filings for Apple
dl.get_8k_filings("AAPL", 5)

# Get all 10-K filings for Microsoft (ticker: MSFT)
dl.get_10k_filings("MSFT")

# Get the latest 10-K filing for Microsoft
dl.get_10k_filings("MSFT", 1)

# Get all 10-Q filings for Visa (ticker: V)
dl.get_10q_filings("V")

# Get all 13F-NT filings for the Vanguard Group (CIK: 0000102909)
dl.get_13f_nt_filings("0000102909")

# Get all 13F-HR filings for the Vanguard Group
dl.get_13f_hr_filings("0000102909")

# Get all SC 13G filings for Apple
dl.get_sc_13g_filings("AAPL")

# Get all SD filings for Apple
dl.get_sd_filings("AAPL")

# Get the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available, for Apple
dl.get_all_available_filings("AAPL", 1)

# Get the latest filings (8-K, 10-K, 10-Q, 13F, SC 13G, SD), if available, for a
# specified list of tickers and CIKs
symbols = ["AAPL", "MSFT", "0000102909", "V", "FB"]
for s in symbols:
    dl.get_all_available_filings(s, 1)

Supported SEC Filings

  • 8-K
  • 10-K
  • 10-Q
  • 13F-NT and 13F-HR
  • SC 13G
  • SD

You can learn more about the different types of SEC filings here.

Contributing

If you encounter a bug or would like to see a new company filing or feature added to sec-edgar-downloader, please file an issue or submit a pull request.

Documentation

For full documentation, please visit sec-edgar-downloader.readthedocs.io.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sec_edgar_downloader-2.2.0-py3-none-any.whl (8.3 kB) Copy SHA256 hash SHA256 Wheel py3
sec-edgar-downloader-2.2.0.tar.gz (8.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page