Python edgar Includes an alternative implementation (a wrapper instead of a fork), to keep compatibility with new sec-edgar-downloader releases. /edgar-idx. Features ¶ Full support for all SEC EDGAR REST API endpoints Automatic pagination handling for filing submissions data Automatic rate-limiting to 10 requests per second to conform with SEC fair access rules Full support for PEP 484-style type hints and the mypy type checker Support for Aug 13, 2025 · Project description edgar-sec A feature-rich python package for interacting with the US Securities and Exchange Commission API: EDGAR Features Now available on Conda-Forge! Native support for asynchronous requests (async). Contribute to gaulinmp/pyedgar development by creating an account on GitHub. Python 3. Class Overview from edgar import Filings, get_filings class Filings: """Collection of SEC filings with filtering and pagination capabilities. 14. 12 -> Answer the question Proceed ( [y]/n)? with y. GitHub Gist: instantly share code, notes, and snippets. Download SEC Filings With Python Find ready-to-execute Python examples to download SEC EDGAR filings and exhibits in their original format or as PDFs. This post is also available as a video tutorial on YouTube. 1. py Program to download EDGAR files from the SEC site by form type. The file_url can represent any EDGAR filing or exhibit from 1993 to present, such as Tesla's 2024 10-K filing: edgarParser helps you parse and analyze SEC filings from the EDGAR database - rsljr/edgarParser Log Analysis on EDGAR Log File Data Set. This guide will take you from installation to your first meaningful analysis. Prerequisites Python 3. 0 Python 3. Getting Started Install edgarpy with pip install edgarpy Project details Download files File details Help Installing packages Uploading packages User guide Project name retention FAQs About PyPI PyPI Blog May 20, 2025 · A better version of sec-edgar-downloader. 1 EDGAR 系统1996 年，美国证券交易委员会（SEC）颁布一项具有深远影响的规定，要求所有美国上市公司（信息披露义务人）必须实施电子化存档。 🤖 Unofficial SEC EDGAR API wrapper for Python. gov via EDGAR using Python 3. Activate the conda env: conda activate edgar Install the Python package edgartools: pip install edgartools Great, we have installed the Python package. Contribute to jadchaar/sec-edgar-api development by creating an account on GitHub. I've read in some sites that it is possible to use Python or R to download a bunch of filings at once. Features ¶ Full support for all SEC EDGAR REST API endpoints Automatic pagination handling for filing submissions data Automatic rate-limiting to 10 requests per second to conform with SEC fair access rules Full support for PEP 484-style type hints and the mypy type checker Support for Python 3. 13. 3 - a Python package on PyPI Dec 2, 2024 · Financial data, AI engineering, sec Edgar filings in python Python library for interacting with EDGAR. Monitor the latest SEC EDGAR filings with Python, Node. Code Examples Here are some python-edgar code examples and snippets. 9. This library partially uses nbdev. EdgarTools makes it simple to access, analyze, and extract insights from SEC filings. 0 Release Date: Oct. It uses Rich and custom reprs to blur the lines between a CLI and the Python REPL. Features SEC API Integration: Direct EDGAR database access with automatic CIK resolution Temporal Alignment: Unified datetime indices across fundamental and market data Advanced Normalization: Built-in handling of XBRL discrepancies and reporting edgarParser helps you parse and analyze SEC filings from the EDGAR database - rsljr/edgarParser Log Analysis on EDGAR Log File Data Set. Setting your identity in Python from edgar import * set_identity("mike. Use command line tools, in the spirit of unix philosophy, to stitch these index files together and create our master index file. Learn how to use edgartools to make these filings accessible and searchable with Python. Historical stock index data can be hard to find for free, but when we use the SEC's EDGAR system and Python, we can extract it quite easily. 0 is the newest major release of the Python programming language, and it contains many new features and optimisations compared to Python 3. You can set your identity in Python before you start using the library. Various use cases are covered, such as how to find SEC filings by ticker, form type, and publication date, how to download historical 10-Q filings over an extended period, or how to find Form 8-K filings by specific Pull all historical data for a company (starting with the first year of availability in SEC-EDGAR database). Key Features Extract financial data from SEC filings using edgartools Support for balance sheet, income statement, and cash flow statement items Calculate annual, quarterly, and trailing twelve month (TTM) metrics Flexible matching of . Contribute to joeyism/py-edgar development by creating an account on GitHub. If Nov 7, 2023 · Download EDGAR financial data (captured on Nov 7, 2023) EDGAR text search and scraping script in Python EDGAR RSS feed parsing script in Python Mar 21, 2024 · Automating SEC Filings Analysis with Python: Introducing TickleMyFilings Yes, another article about Parsing Edgar. Oct 27, 2022 · If the links get appended to the list I would ideally like to download all of them at once and save in folder. To download EDGAR filings and exhibits as PDFs, use the . org Powerful Python library for SEC data analysis and financial research. Our Goal Extract and standardize financial sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. Nov 22, 2012 · The link below is a library that parses EDGAR filings into a SQLite DB. It includes: For information on how EDGAR filers may use APIs to check EDGAR system status, manage users, submit EDGAR filings, and check the status of submitted filings, see How Do I Understand EDGAR Application Programming Interfaces, How Do I Create and Manage Filer and User API Tokens, Overview of EDGAR APIs, and the API Development Toolkit. # Create virtual environment python -m venv edgar-env # Activate (Linux/macOS) source edgar-env/bin/activate # Activate (Windows) edgar-env\Scripts\activate # Install edgartools pip install edgartools # Deactivate when done deactivate Performance Optimization For optimal performance: Use Local Storage to download and work with SEC filings locally In this video, we'll see how you can scrape financial reporting data from SEC Edgar using Python and the Edgartools library. The Query API allows us to filter the EDGAR database using different search criteria, such as form types, filing dates, tickers, and more. Pull all historical data for a company (starting with the first year of availability in SEC-EDGAR database). I am trying to identify specific data points from SEC Filing Explore and run machine learning code with Kaggle Notebooks | Using data from SEC EDGAR CIK ticker exchange JSON file This Python tutorial demonstrates how to extract specific sections of textual data from SEC EDGAR 10-K filings, without relying on regular expressions or custom BeautifulSoup extractors. Dec 26, 2022 · python real-time stream websocket websockets gov xbrl edgar-scraper edgar edgar-database edgar-crawler cik 10-k filings 8-k edgar-api sec-api gov-edgar-filings insider-trading Updated on Jan 9, 2024 JavaScript Dec 16, 2021 · Please help, SEC EDGAR used to work flawlessly until now. sec. Nov 20, 2020 · OpenEDGAR is an open source Python framework designed to rapidly construct research databases based on the Electronic Data Gathering, Analysis, and Retrieval (EDGAR) system operated by the US Securities and Exchange Commission (SEC). Dec 27, 2022 · I want to pull reports from the SEC EDGAR API and conduct analysis within python. All the code from this video can be found on my Github. Analyze Company Financials. Please see his package information page here. Local caching for easier data access and faster Hi, I'm starting to read quite a bit of 10K's and 10Q's and I find it extremely boring to download them 1 by 1 through EDGAR. python-edgar does only one thing and does it well: getting and cleaning uncompressed quarterly index files to your computer. Please note: my program stores all paths in an SQLite database. A powerful, modern Python application for downloading, processing, and analyzing SEC EDGAR filings with professional-grade workflow automation. """ Constructor Filing (cik, company, form, filing_date, accession_no sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. This forms a semantic tree that corresponds to the visual and informational structure of the document. Major new features of the 3. py, is designed to fetch and analyze SEC filings specifically related to "Material Cybersecurity Incidents" and "Item 1. It features: 3 commands only to download any type of filings for any period of time auto throttling of download speed to adhere to the SEC policy of fair use Install edgar-analyzer Feb 22, 2024 · 背景介绍1. com") Setting your identity using an environment variable You can also set your identity using an environment variable. Aug 12, 2021 · python-edgar does only one thing and does it well: getting and cleaning uncompressed quarterly index files to your computer. it gives HTTPError: HTTP Error 403: Forbidden Jun 3, 2025 · Add your description hereFundamentalData A Python package for institutional-grade SEC financial data analysis with integrated market context. I personally like the lightweight database product very much. Python application used to download, parse, and extract structured/unstructured data from filings in the SEC Edgar Database (including 10-K, 10-Q, 13-D, S-1, 8-K, etc. Convert XBRL-to-JSON and access standardized financial state Feb 28, 2015 · I write the following Python program to execute the first step. 14 series, compared to 3. Contribute to BrelLibrary/brel development by creating an account on GitHub. ) Sep 8, 2023 · This post documents how to download SEC filings from EDGAR using edgar-analyzer, a Python program I wrote. 14 are: New features PEP 779: Free-threaded python data-mining financial-data sec edgar financial-reporting dera Updated on Dec 14, 2021 Python Jun 25, 2021 · Downloading files from sec. js and any other language supporting websocket or socket. The goal for this project is to make it easy to get filings from the SEC website onto your computer for the companies and forms you desire. read_csv to have the data programmatically usable. Python SEC EDGAR Filings API. gov on Edgar initialization, pass in a local path to the data Quick Start Guide Get up and running with EdgarTools in 5 minutes. Jun 13, 2023 · Recommended: Python Requests Library – Your First HTTP Request in Python Caution and Consideration While this technique may help bypass the 403 error, it’s crucial to emphasize that it should be used responsibly. tsv file from the data. csvreader or pandas. EdgarTools is the fastest, most powerful open-source library for SEC EDGAR data extraction. mccalum@indigo. Key Features Intuitive API: Access financial statements with simple, readable method calls Multi-period Analysis: Compare financial data across quarters and years with statement stitching Standardized Filings API Reference The Filings class represents a collection of SEC filings with powerful filtering, navigation, and data manipulation capabilities. Solve Real Problems with EdgarTools This document showcases common workflows and tasks that financial professionals, developers, and researchers can accomplish using EdgarTools. ) A Python library for reading XBRL reports. On the other hand, the Render API enables us to download I need to download all 8-K filings in SEC Edgar Database (approximately 3500 companies), anyone knows how to do it with a software or a code? I tried with the sec-edgar-downloader (https://pypi. S. Features comprehensive parsing for 10-K, 10-Q, 8-K forms, XBRL financial data extraction, and real-time company filings retrieval. Have previously used sec_edgar_downloader package however it downloads all the 10-k files in their respective yearly folders. Securities and Exchange Commission (SEC). EDGAR is the primary system for submissions by companies and others who are required by law to file information with the SEC. 0). Sep 5, 2024 · Python Library to interact with the SEC Edgar files Project description edgarpy Python library to interact with the SEC Edgar filings. All method outputs are mapped to dataclasses for better usability. gov/edgar website. Home › Textual Analysis Resources › Code Python Python files EDGAR_DownloadForms_v2022. Searches can be conducted either by stock ticker or Central Index Key (CIK). From what I can tell, it looks like the main issue is that I'm using the wrong file format, but methods I have foun Feb 4, 2022 · Errors A list of common python-edgar errors. Set your identity once: from edgar Oct 3, 2013 · Once python-edgar is finished downloading index files, you can open an index file with csv. Feb 13, 2025 · sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. moving averages). The SEC might have legitimate reasons for preventing certain types of access to their system. Class Overview from edgar import Filing class Filing: """Represents a single SEC filing with access to documents and data. We use Python 3 and the SEC-API. Features Full support for all SEC EDGAR REST API endpoints Automatic pagination handling for filing submissions data Automatic rate-limiting to 10 requests per second to conform with SEC fair access rules Full support for PEP 484-style type hints Oct 27, 2022 · If the links get appended to the list I would ideally like to download all of them at once and save in folder. You will learn how to convert XBRL data into a pandas dataframe, extract income statements and balance sheets from 10-K filings, and build financial tables from EDGAR XBRL files. Feb 6, 2023 · I am attempting to scrape individual fund holdings from the SEC's N-PORT-P/A form using beautiful soup and xml. After watching this video, you s The web version of the popular edgartools Python library. ) that explains how to do so to someone with only a basic understanding of these programming languages? Thanks!! Sep 1, 2024 · Python-EDGAR 使用教程项目介绍Python-EDGAR 是一个用于从美国证券交易委员会（SEC）的 EDGAR 数据库下载和解析文件的 Python 库。该库允许用户轻松访问自 1993 年以来的 SEC 文件索引，并支持多种文件类型，如 10-K、10-Q、13-D 和 8-K 等。 Jun 9, 2024 · Overview The sec-parser project simplifies extracting meaningful information from SEC EDGAR HTML documents by organizing them into semantic elements and a tree structure. Whether you're analyzing company financials, tracking insider trading, or researching investment funds, edgartools provides the tools you need. e. ), funds (ETFs, hedge funds, etc. 9 Asked 4 years, 5 months ago Modified 4 years, 4 months ago Viewed 8k times We would like to show you a description here but the site won’t allow us. sec-edgar-api ¶ sec-edgar-api is a lightweight, unofficial Python API wrapper for the SEC EDGAR REST API. , modules you must download that are accessed by the program): MOD_EDGAR_Forms. Here's why you should use it: Oct 3, 2013 · Download the SEC fillings index from EDGAR since 1993 - 3. The SEC EDGAR system, and its large amount of financial data provided in company filings, can be accessed using Python libraries. find_company_name("Cisco System") To avoid pull of all company data from sec. I have been a very keen follower of the posts on this site. Each journey addresses a specific problem and provides a concise code example. get_pdf(file_url) function from the PdfGeneratorApi class in the sec-api Python package. EdgarTools Powerful Python library for SEC data analysis and financial research EdgarTools makes it simple to access, analyze, and extract insights from SEC filings. Build a master index of SEC filings I use the python-edgar to download quarterly zipped index files to . The world's easiest, most powerful edgar library. Considering the poorly adhered to standard for the filings, writing your own parsing script would be a significant undertaking. Filing API Reference The Filing class represents a single SEC filing and provides access to its documents, data, and metadata. Dec 17, 2024 · How to Get Any Company’s Financial Data for Free Using Python and SEC EDGAR API Ever wondered how to get reliable financial data without paying for expensive subscriptions? Look no further Jul 16, 2025 · SEC filings are corporate report cards revealing everything from profits to fraud. Jul 20, 2024 · python finance sec edgar edgar-database edgar-crawler cik financials Updated on Jul 20 Python The tutorial explains how to find all URLs of XML files attached to SEC EDGAR filings to download the identified XML files with Python. Jan 21, 2022 · Unofficial SEC EDGAR API wrapper for Pythonsec-edgar-api sec-edgar-api is a lightweight, unofficial Python API wrapper for the SEC EDGAR REST API. In this tutorial, I will show you how to scrape financial data from the SEC Edgar database using Python and the edgartools library. See full list on pypi. 🏛️ Open-source toolkit for accessing SEC EDGAR financial data with Python and TypeScript/JavaScript SDKs. io Python package to help us find the links to all 10-K filings on EDGAR and then download them. Apr 11, 2019 · Apologies in advance for long question- I am new to Python and I'm trying to be as explicit as I can with a fairly specific situation. sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. Search SEC Filings With Python This page provides ready-to-execute examples demonstrating how to search and retrieve metadata of EDGAR filings from 1993 to present with Python. io. Welcome to Python SEC Edgar’s documentation! ¶ Python SEC Edgar Features Quick Start Guide Configure Settings (Optional) Alright, what did I just do? Why download the Complete Submission Filing? Central Index Key (CIK) Accession Number Filings Statistics Download Time Estimates Todo Installation From sources Usage Contributing Types of About A Python tool to connect to the SEC's EDGAR database and download key financial data like income statements, balance sheets, and cash flow statements. A Python application used to download and parse complete submission filings from the sec. The tutorial covers the extraction of any of the 19 10-K filing sections, from "Item 1 - Business" to "Item 7 - MD&A, Management’s Discussion of Financial Results" to "Item 14 - Principal Accountant Fees and Do you know of any API (paid or free), tool or python package which can parse individual sections SEC 10-K filings? I'm looking for the individual sections of 10-K filings (e. 6+ Quick Start ¶ Installation ¶ Install and update this package using pip: I am the author of edgartools - a python library for working with SEC filings. This monorepo contains: TypeScript Package: Full-featured TypeScript/JavaScript library with type safety Python Package: Pythonic interface for data analysis and research Dec 1, 2021 · This paper introduces the R package edgar to download and analyze the Securities and Exchange Commission’s (SEC) mandatory public disclosures in the U… This repository contains a Python Web scraper for parsing 13F filings (mutual fund holdings) from SEC's website, EDGAR, and writing a . ITEM 1: Business, sec-edgar-downloader is a Python package for downloading company filings from the SEC EDGAR database. This program borrows some codes from Edouard Swiac’s Python module “python-edgar” (version: 1. 13 Some of the major new features and changes in Python 3. It serves as the foundation for all filing-related operations in EdgarTools. Remember that the delimiter character is |! python-edgar can be used as a library called from another python script, or as a standalone script. Features Full support for all SEC EDGAR REST API endpoints Automatic pagination handling for filing submissions data Automatic rate-limiting to 10 requests per second to conform with SEC fair access rules Full support for PEP 484-style type hints May 23, 2023 · Using Python to Retrieve 13F Reports from EDGAR With the rise of data-driven decision making, investors are leveraging technology to gain deep insights into their investment targets. Getting XBRL from Filings Overview The edgar. Ideal for value investing, it automates the retrieval of essential financial metrics for informed investment decisions. Over 18 million filings, all 150 filing types supported. Dependencies (i. Oct 13, 2024 · from edgar import Edgar edgar = Edgar() possible_companies = edgar. g. Dec 26, 2022 · python real-time stream websocket websockets gov xbrl edgar-scraper edgar edgar-database edgar-crawler cik 10-k filings 8-k edgar-api sec-api gov-edgar-filings insider-trading Updated on Jan 9, 2024 JavaScript This Python script, edgar-8k105. gov EDGAR filings query, extraction, parser and real-time streaming API A small library to access files from SEC's edgar. Oct 16, 2024 · XBRL is a data format used by companies, mainly for financial reporting in their 10-Q and 10-K filings. It employs the SEC's EDGAR database to retrieve these filings and analyze their potential impact on stock prices using Yahoo Finance data. Various use cases are covered, such as how to find SEC filings by ticker, form type, and publication date, how to download historical 10-Q filings over an extended period, or how to find Form 8-K filings by specific Getting Started To begin, we need to install the sec-api Python package, which will enable us to utilize the Query API and Render API for accessing and downloading SEC filings from the EDGAR database. py - module that can be imported to provide convenient lists of form variants. Search, filter, and analyze SEC filings with modern tools. 🚀 Quick Start • 📖 Documentation • 💼 Examples • 🔧 Installation • ⚡ Workflows Download all companies periodic reports, filings and forms from EDGAR database. Our SEC filings download application will be structured into two components: The first component of our Python application finds all URLs of 10-K filings on EDGAR filed May 27, 2020 · 1. Features Advantages over sec-edgar-downloader: Flexibility in Download Process Tailored for choosing what, where, and how to download. - sec-edgar/sec-edgar To begin, we need to install the sec-api Python package, which will enable us to utilize the Query API and Render API for accessing and downloading SEC filings from the EDGAR database. Built for financial analysts, data scientists, and AI developers who need reliable, production-ready access to SEC filings. Contribute to dgunning/edgartools development by creating an account on GitHub. A typical submission, outlined below and [linked here][1], looks like: <edgarSubmi Nov 4, 2025 · How to Parse 10-K Report from EDGAR (SEC). Dec 27, 2022 · Python library for working with SEC Edgar. xbrl module provides a powerful yet user-friendly API for processing XBRL (eXtensible Business Reporting Language) financial data from SEC filings. Next, we have to set the edgar user identity. edgarParser "EDGAR is the Electronic Data Gathering, Analysis, and Retrieval system used at the U. Example Resources All examples are in the examples/ directory: 📓 Interactive Notebooks Explore 28 Jupyter notebooks organized by topic Apr 12, 2022 · I am trying to extract entire textual data from the given URL below as an example. I tried every code posted here - they are giving error, eg AttributeError: 'NoneTy May 14, 2025 · bellingcat/EDGAR This is a command line interface to search and retrieve corporate and financial data from the United States Securities and Exchange Commission (SEC). That library and code Creating a new Codespace automatically takes care of installing all supported Python interpreters, the Poetry package manager, Python dependencies, and pre-commit hooks for you. The SEC EDGAR Toolkit provides easy-to-use libraries for both TypeScript/JavaScript and Python developers to access and work with SEC filing data from the EDGAR database. Analyze financial data using various metrics for time series data (i. """ Backend: Uses Dec 6, 2020 · I am trying to install Python Edgar library I used the following code Python SEC Edgar Python application used to download and parse complete submission filings from the sec. Welcome to this Python tutorial on how to extract financial data from XBRL in SEC filings using Python. Semantic elements might include section titles, paragraphs, and tables, each classified for easier data manipulation. I have many URLs so automating. It contains functionality to pull Form10k and Form8Qk filings from the EDGAR FPT site for years that you specify and load them into a normalized format in SQLite DB tables. Let's dive in and see how to automate getting SEC filing data and company financial data from the SEC EDGAR API in python. I have been working A better version of sec-edgar-downloader. You can skip having to write poetry run before each command by activating Poetry's virtual environment with poetry shell. It serves as the primary interface for working with multiple filings in EdgarTools. Aug 4, 2023 · Create a conda environment (env): conda create -n edgar python=3. One such … EDGAR-CRAWLER is the only open-source toolkit that downloads raw and unstructured financial SEC filings from EDGAR and parses them into structured JSON files in order to bootstrap financial NLP experiments. The examples cover how to locate and download historical 10-K and 10-Q filings to local disk, export financial statements from these filings as Excel files, download XBRL data files attached to EDGAR filings, and retrieve various exhibits such This Python tutorial demonstrates how to extract specific sections of textual data from SEC EDGAR 10-K filings, without relying on regular expressions or custom BeautifulSoup extractors. What is the SEC's EDGAR database? EDGAR is a database of corporate filings maintained by the SEC. org/ EdgarTools Powerful Python library for SEC data analysis and financial research EdgarTools makes it simple to access, analyze, and extract insights from SEC filings. A couple years it has grown into a large toolset for finding data on Edgar in a really intuitive way. These filings contain a wealth of quantitative and qualitative information on every legal entity that issues non-exempt securities Download financial reports as Excel files attached to 10-K and 10-Q filings with Python, and learn how to search and filter the EDGAR database. Edgartools is a python library that makes it super easy to navigate SEC filings in Python Why Use Edgartools? Edgartools stands out as the most intuitive and powerful Python library for working with SEC EDGAR data. On the other hand, the Render API enables us to download any EDGAR Oct 28, 2022 · We use Python 3 and the SEC-API. 8 or higher Internet connection Basic familiarity with Python Step 1: Install EdgarTools pip install edgartools Step 2: Set Your Identity The SEC requires all API users to identify themselves. Implement a real-time SEC EDGAR monitor with less than ten lines of code. Jul 24, 2025 · Edgar Financial Analysis Toolkit A Python package for extracting and analyzing financial statement data from SEC filings using XBRL data and Yahoo Finance. This is useful if you are using the library in a script or notebook. ), financial advisors, business development companies, and more. edgartools can extract data from XBRL files into dataframes as well as into custom Python classes that allow you to manipulate and visualize the data inside. 7, 2025 This is the stable release of Python 3. Search and access full text of electronic filings for Benco, LLC on SEC's EDGAR database. May 8, 2025 · SEC-Edgar implements a basic crawler for downloading This tutorial shows how to download and scrape 10-K filings from SEC EDGAR to your local disk. You can do this in several ways. Do you know any source (video, blog, etc. 05". Query, full-text search and real-time stream API. python finance financial stock-market stocks financial-data mutual-funds sec-edgar edgar Updated on Sep 7 Python Jul 21, 2021 · Let’s explore how to extract and generate financial statements from 10-Q and 10-K SEC EDGAR filings using Python, pandas dataframes and SEC API. Jun 16, 2021 · sec-api is a Python package for searching and accessing the entire SEC EDGAR filings corpus, providing access to petabytes of regulatory data from public and private companies, insiders (directors, board members, etc. Contribute to JieFrye/LogAnalysis development by creating an account on GitHub.