# dgunning/edgartools

Read and analyze SEC EDGAR filings in Python. 10-K, 8-K, XBRL financials, Form 3/4/5, 13F, ADV — clean API, well-typed, MIT-licensed.

Repository: https://github.com/dgunning/edgartools
Canonical: https://ross.abutalabs.com/products/edgartools
Homepage: https://edgartools.readthedocs.io/
Language: Python
License: MIT
License Family: permissive
Topics: 10-k, 10-q, balance-sheet, edgar, filings, financials, insider-trading, sec, xbrl, 13-f, form-4, income-statement, cashflow-statement, company, cusip, tickers, bdc, 8-k
Last push: 2026-08-26T14:00:20+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 96
- inputs: {"age_days": 1348, "days_push": 7, "days_rel": 8, "gap_med": 2.0, "n_releases_24m": 175}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2624, forks 470 (observed 2026-08-28T04:07:05.072668+00:00)

## What it is
EdgarTools is a Python library for accessing and parsing SEC EDGAR filings as structured, typed Python objects. It provides a clean API for financial statements, insider trades, fund holdings, and 20+ other filing types with XBRL standardization.

## Use cases
- parse 10-K income statements from SEC EDGAR in Python
- extract insider trading data from Form 4 filings
- get XBRL financials for a company by ticker
- analyze 13F fund holdings
- download and parse 8-K filings programmatically
- compare balance sheets across companies
- retrieve SEC filings data for quantitative analysis

## When to choose
- you need structured SEC filing data in Python without manual XBRL parsing
- building financial analysis or quant research pipelines on EDGAR data
- you want a well-typed, MIT-licensed library with an active maintainer

## When to avoid
- you need real-time market data rather than regulatory filings
- you work outside Python or need a REST API service
- you only need a few filings and prefer raw EDGAR downloads

## Facets
- artifact type: library
- maturity: active
- function: parser, data-science, etl
- domain: apis
- platform: python
- tags: sec-edgar, xbrl, financial-filings, 10-k, 10-q, 8-k, form-4, 13f, insider-trading, financial-statements, finance, data-engineering

## Member repositories
- dgunning/edgartools (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:05.072668+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:19:52.753669+00:00, confidence not recorded.
  - readme: https://github.com/dgunning/edgartools (fetched 2026-08-28T04:07:05.072668+00:00, sha cda56280b8c3)
- Data as of 2026-08-30T08:39:29.467469+00:00.