{"info":{"author":null,"author_email":"Dwight Gunning <dgunning@gmail.com>","bugtrack_url":null,"classifiers":["Development Status :: 4 - Beta","Intended Audience :: Developers","Intended Audience :: Financial and Insurance Industry","Intended Audience :: Science\/Research","License :: OSI Approved :: MIT License","Programming Language :: Python","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.14","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Office\/Business :: Financial","Topic :: Office\/Business :: Financial :: Investment","Topic :: Scientific\/Engineering :: Information Analysis"],"description":"<a href=\"https:\/\/github.com\/dgunning\/edgartools\">\n  <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/edgartools-mark.svg\" alt=\"EdgarTools logo\" align=\"left\" height=\"80\" hspace=\"20\">\n<\/a>\n\n# EdgarTools \u2014 Python Library for SEC EDGAR Filings\n\n<br clear=\"left\">\n\n<p>\n  <a href=\"https:\/\/pypi.org\/project\/edgartools\"><img src=\"https:\/\/img.shields.io\/pypi\/v\/edgartools.svg\" alt=\"PyPI - Version\"><\/a>\n  <a href=\"https:\/\/github.com\/dgunning\/edgartools\/actions\"><img src=\"https:\/\/img.shields.io\/github\/actions\/workflow\/status\/dgunning\/edgartools\/python-hatch-workflow.yml\" alt=\"GitHub Workflow Status\"><\/a>\n  <a href=\"https:\/\/github.com\/dgunning\/edgartools\/actions\/workflows\/regression-tests.yml\"><img src=\"https:\/\/img.shields.io\/github\/actions\/workflow\/status\/dgunning\/edgartools\/regression-tests.yml?branch=main&label=regression\" alt=\"Regression Tests\"><\/a>\n  <a href=\"https:\/\/www.codefactor.io\/repository\/github\/dgunning\/edgartools\"><img src=\"https:\/\/www.codefactor.io\/repository\/github\/dgunning\/edgartools\/badge\" alt=\"CodeFactor\"><\/a>\n  <a href=\"https:\/\/github.com\/dgunning\/edgartools\/blob\/main\/LICENSE\"><img src=\"https:\/\/img.shields.io\/github\/license\/dgunning\/edgartools\" alt=\"GitHub\"><\/a>\n  <a href=\"https:\/\/edgartools.readthedocs.io\/\"><img alt=\"Documentation\" src=\"https:\/\/img.shields.io\/badge\/docs-edgartools-blue\"><\/a>\n  <img alt=\"Pepy Total Downloads\" src=\"https:\/\/img.shields.io\/pepy\/dt\/edgartools\">\n  <a href=\"https:\/\/pepy.tech\/project\/edgartools\"><img alt=\"Pepy Monthly Downloads\" src=\"https:\/\/static.pepy.tech\/badge\/edgartools\/month\"><\/a>\n  <a href=\"https:\/\/github.com\/dgunning\/edgartools\/stargazers\"><img alt=\"GitHub stars\" src=\"https:\/\/img.shields.io\/github\/stars\/dgunning\/edgartools?style=social\"><\/a>\n\n<\/p>\n\n**EdgarTools** is a Python library for accessing SEC EDGAR filings as structured data. Parse financial statements, insider trades, fund holdings, proxy statements, and 20+ other filing types with a consistent Python API \u2014 in a few lines of code. Free and open source.\n\n![EdgarTools SEC filing data extraction demo](https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/edgartools-demo.gif)\n\n## Why EdgarTools?\n\nSEC EDGAR has every filing back to 1994, free \u2014 and almost none of it is ready to use. EdgarTools turns any filing into a typed Python object, so a 10-K's revenue is one line instead of an afternoon of XBRL parsing.\n\n```python\n# Apple's latest income statement \u2014 rendered, standardized, done\nfrom edgar import Company\nCompany(\"AAPL\").get_financials().income_statement()\n```\n\n<table align=\"center\">\n<tr>\n  <td align=\"center\" width=\"33%\">\n    <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/icon-data.svg\" width=\"96\" alt=\"Financial Statements\"><br>\n    <b>Financial Statements<\/b><br>\n    Income, balance sheet, cash flow in one call<br>\n    XBRL-standardized for cross-company comparison\n  <\/td>\n  <td align=\"center\" width=\"33%\">\n    <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/icon-filings.svg\" width=\"96\" alt=\"Every Filing Type\"><br>\n    <b>Every Filing Type<\/b><br>\n    13F holdings, Form 4 insiders, 8-K events, funds, proxies<br>\n    Typed objects + pandas DataFrames for 20+ forms\n  <\/td>\n  <td align=\"center\" width=\"33%\">\n    <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/icon-ai.svg\" width=\"96\" alt=\"Built for Pipelines & AI\"><br>\n    <b>Built for Pipelines &amp; AI<\/b><br>\n    Rate-limit aware, smart caching, enterprise mirrors<br>\n    Built-in MCP server + LLM-ready text for RAG\n  <\/td>\n<\/tr>\n<\/table>\n\n## How It Works\n\nEverything starts with a **`Company`** or a **`Filing`**. Call **`.obj()`** and you get a typed object built for that form \u2014 its data ready as pandas DataFrames and clean text.\n\n<p align=\"center\">\n  <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/how-it-works.svg\" alt=\"How EdgarTools turns any SEC filing into a typed Python object\">\n<\/p>\n\nThe same typed output that reads cleanly in a notebook drops straight into a pipeline: DataFrames for your warehouse, LLM-ready text and an MCP server for your AI stack, rate-limit and enterprise-mirror aware for scale.\n\n## Quick Start\n\n**1. Install**\n\n```bash\npip install edgartools\n```\n\n**2. Identify yourself to the SEC** \u2014 EDGAR requires an email with every request. No key, no signup, no rate-limit tier; set it once:\n\n```python\nfrom edgar import *\nset_identity(\"your.name@example.com\")\n```\n\n**3. Get data** \u2014 every filing is now a few lines away:\n\n```python\n# Standardized financial statements, straight from XBRL\nCompany(\"AAPL\").get_financials().income_statement()\n\n# The latest insider Form 4 as a structured object\nCompany(\"AAPL\").get_filings(form=\"4\").latest().obj()\n```\n\n![Apple SEC Form 4 insider transactions parsed into a structured Python object](https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/quickstart-form4.gif)\n\n**Next:** explore the [Use Cases](#use-cases) below, or dive into the [documentation](https:\/\/edgartools.readthedocs.io\/) and [Quick Guide](https:\/\/edgartools.readthedocs.io\/en\/latest\/quick-guide\/).\n\n## Use Cases\n\n### Financial statements from 10-K and 10-Q filings\n\n```python\nfinancials = Company(\"MSFT\").get_financials()\nfinancials.balance_sheet()     # all line items\nfinancials.income_statement()  # revenue, net income, EPS\n```\n[Financial Statements guide \u2192](https:\/\/edgartools.readthedocs.io\/en\/latest\/guides\/financial-data\/)\n\n### Insider trading from SEC Form 4\n\n```python\nform4 = Company(\"TSLA\").get_filings(form=\"4\").latest().obj()\nform4.to_dataframe()  # insider buy\/sell transactions\n```\n[Insider Trades guide \u2192](https:\/\/edgartools.readthedocs.io\/en\/latest\/insider-filings\/)\n\n### 13F institutional holdings & hedge fund portfolios\n\n```python\nthirteenf = get_filings(form=\"13F-HR\").latest().obj()\nthirteenf.holdings  # every portfolio position as a DataFrame\n```\n[Institutional Holdings guide \u2192](https:\/\/edgartools.readthedocs.io\/en\/latest\/guides\/thirteenf-data-object-guide\/)\n\n### 8-K current reports & corporate events\n\n```python\neightk = get_filings(form=\"8-K\").latest().obj()\neightk.items  # reported event items\n```\n[Current Events guide \u2192](https:\/\/edgartools.readthedocs.io\/en\/latest\/guides\/eightk-data-object-guide\/)\n\n### XBRL financial data across companies\n\n```python\nfacts = Company(\"AAPL\").get_facts()\nfacts.query().by_concept(\"Revenue\").to_dataframe()  # revenue history as a DataFrame\n```\n[XBRL Deep Dive \u2192](https:\/\/edgartools.readthedocs.io\/en\/latest\/xbrl\/)\n\n## Key Features\n\n<table>\n<tr>\n<td width=\"50%\" valign=\"top\">\n\n**Financial data**\n- Income, balance sheet, cash flow \u2014 XBRL-standardized for cross-company comparison\n- Individual line items, dimensional data, multi-period comparatives\n- Company Facts API: time-series for any concept across years\n\n**Funds & ownership**\n- 13F holdings, N-PORT, N-MFP, N-CSR\/N-CEN fund reports\n- Form 3\/4\/5 insider transactions; Schedule 13D\/G ownership\n- Position tracking over time\n\n<\/td>\n<td width=\"50%\" valign=\"top\">\n\n**Filings & text**\n- Typed objects for 20+ forms; complete history since 1994\n- Section extraction (Risk Factors, MD&A), EX-21 subsidiaries, auditor info\n- HTML \u2192 clean text + markdown for RAG; full-text search\n- Ticker\/CIK lookup, industry & exchange filtering\n\n**Built for production**\n- Configurable rate limiting + enterprise\/academic mirrors\n- Smart caching, type hints throughout, 1000+ tests\n- [Enterprise configuration \u2192](docs\/configuration.md#enterprise-configuration)\n\n<\/td>\n<\/tr>\n<\/table>\n\nEdgarTools supports all SEC form types including **10-K annual reports**, **10-Q quarterly filings**, **8-K current reports**, **13F institutional holdings**, **Form 4 insider transactions**, **proxy statements (DEF 14A)**, **S-1 registration statements**, **N-CSR fund reports**, **N-MFP money market data**, **N-PORT fund portfolios**, **Schedule 13D\/G ownership**, **Form D offerings**, **Form C crowdfunding**, and **Form 144 restricted stock**. Parse XBRL financial data, extract text sections, and convert filings to pandas DataFrames.\n\n## Comparison with Alternatives\n\nEdgarTools is a **Python library** that talks directly to SEC EDGAR. [sec-api](https:\/\/sec-api.io) is the best-known **hosted API** that returns JSON. Both parse filings \u2014 the difference is how you work with the data, and what it costs you.\n\n| | EdgarTools | sec-api |\n|---|------------|---------|\n| **Cost** | Free, MIT | $49+\/mo |\n| **Data format** | Typed Python objects \u2192 DataFrames | JSON you parse yourself |\n| **Where it runs** | In your process \u2014 no key, no quotas, no vendor lock-in | Hosted API \u2014 key + rate tiers |\n| **Filing coverage** | 20+ typed forms (10-K, 8-K, 13F, N-PORT, proxy\u2026) | 15+ structured endpoints |\n| **AI \/ MCP** | <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/compare-check.svg\" width=\"20\"> Built in | <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/compare-cross.svg\" width=\"20\"> |\n| **Open source** | <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/compare-check.svg\" width=\"20\"> Inspect, fork, self-host | <img src=\"https:\/\/raw.githubusercontent.com\/dgunning\/edgartools\/main\/docs\/images\/icons\/compare-cross.svg\" width=\"20\"> Proprietary |\n\n**Bottom line:** in Python, EdgarTools gives you typed objects, AI-native output, and the full SEC corpus \u2014 free, open, and inspectable, with no keys or bills. `pip install edgartools` and you're querying filings in two lines.\n\n## Library or hosted?\n\n**EdgarTools** is the open-source library \u2014 SEC-filing primitives you compose in your own code, free and self-run.\n\n[**edgar.tools**](https:\/\/edgar.tools) is the hosted platform built on that same open engine: the full SEC corpus as a managed service, so your team gets the data without running the pipeline \u2014 and without the black box of a closed API.\n\nReach for the library when you want control in your own stack; reach for **edgar.tools** when you'd rather not operate it yourself.\n\n## AI Integration\n\n### Use EdgarTools with Claude Code & Claude Desktop\n\nEdgarTools includes an MCP server and AI skills for Claude Desktop and Claude Code. Ask questions in natural language and get answers backed by real SEC data.\n\n- *\"Compare Apple and Microsoft's revenue growth rates over the past 3 years\"*\n- *\"Which Tesla executives sold more than $1 million in stock in the past 6 months?\"*\n\n<details>\n<summary><b>Setup Instructions<\/b><\/summary>\n\n### Option 1: AI Skills (Recommended)\n\nInstall the EdgarTools skill for Claude Code or Claude Desktop:\n\n```bash\npip install \"edgartools[ai]\"\npython -c \"from edgar.ai import install_skill; install_skill()\"\n```\n\nThis adds SEC analysis capabilities to Claude, including 3,450+ lines of API documentation, code examples, and form type reference.\n\n### Option 2: MCP Server\n\nRun EdgarTools as an MCP server for any AI client -- Claude Desktop, Cline, or your own containerized deployment.\n\nAdd to Claude Desktop config (`~\/Library\/Application Support\/Claude\/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"edgartools\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"edgartools[ai]\", \"edgartools-mcp\"],\n      \"env\": {\n        \"EDGAR_IDENTITY\": \"Your Name your.email@example.com\"\n      }\n    }\n  }\n}\n```\n\nRequires [uv](https:\/\/docs.astral.sh\/uv\/). Alternatively, `pip install \"edgartools[ai]\"` and use `python -m edgar.ai`.\n\nSee [AI Integration Guide](docs\/ai-integration.md) for complete documentation.\n\n<\/details>\n\n## \u2764\ufe0f Support This Project\n\nEdgarTools runs in production at hedge funds, fintechs, and research desks \u2014 MIT-licensed, no keys, no subscriptions, and maintained by one person.\n\nThe SEC amends filing formats every quarter and ships a new XBRL taxonomy every year. Sponsorship is what keeps 20+ parsers current and funds new extractors as fresh disclosure types appear.\n\n<p align=\"center\">\n  <a href=\"https:\/\/github.com\/sponsors\/dgunning\" target=\"_blank\">\n    <img src=\"https:\/\/img.shields.io\/badge\/Sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=EA4AAA\" alt=\"Sponsor on GitHub\" height=\"44\">\n  <\/a>\n  &nbsp;&nbsp;\n  <a href=\"https:\/\/www.buymeacoffee.com\/edgartools\" target=\"_blank\">\n    <img src=\"https:\/\/img.shields.io\/badge\/Buy_me_a_coffee-FFDD00?style=for-the-badge&logo=buymeacoffee&logoColor=black\" alt=\"Buy Me A Coffee\" height=\"44\">\n  <\/a>\n<\/p>\n\n<p align=\"center\">\n  <sub>Recurring sponsorship + corporate tiers via GitHub \u00b7 One-time thanks via Buy Me a Coffee<\/sub>\n<\/p>\n\n---\n\n### For teams running EdgarTools in production\n\nIf EdgarTools is in your data pipeline, [GitHub Sponsors](https:\/\/github.com\/sponsors\/dgunning) offers corporate tiers from **$250 to $1,500\/mo** with:\n\n- Response SLAs (24h\u201348h first response on critical issues)\n- Quarterly strategy calls and roadmap input\n- Logo placement in this README\n- 7-day early access for internal regression testing\n- Annual invoicing through GitHub \u2014 procurement-friendly\n\n\u2192 **[See sponsor tiers](https:\/\/github.com\/sponsors\/dgunning)**\n\n## Community & Support\n\n### Documentation & Resources\n\n- [Documentation](https:\/\/edgartools.readthedocs.io\/)\n- [Notebooks \/ Examples](https:\/\/edgartools.readthedocs.io\/en\/latest\/notebooks\/)\n- [Quick Guide](https:\/\/edgartools.readthedocs.io\/en\/latest\/quick-guide\/)\n- [EdgarTools Blog](https:\/\/www.edgartools.io)\n\n### Get Help & Connect\n\n- [GitHub Issues](https:\/\/github.com\/dgunning\/edgartools\/issues) - Bug reports and feature requests\n- [Discussions](https:\/\/github.com\/dgunning\/edgartools\/discussions) - Questions and community discussions\n\n### Contributing\n\nContributions welcome:\n\n- **Code**: Fix bugs, add features, improve documentation\n- **Examples**: Share interesting use cases and examples\n- **Feedback**: Report issues or suggest improvements\n- **Spread the Word**: Star the repo, share with colleagues\n\nSee our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Professional Services\n\nNeed help building production SEC data infrastructure? The creator of EdgarTools offers consulting for teams building financial AI products:\n\n- **SEC Data Sprint** (1\u20133 days) \u2014 Working prototype on your data\n- **Architecture Review** (1\u20132 weeks) \u2014 Pipeline audit with prioritized fixes\n- **Pipeline Build** (2\u20134 weeks) \u2014 Production-ready code, tests, and handoff\n\n[Learn more \u2192](https:\/\/www.edgar.tools\/consulting)\n\n---\n\n<p align=\"center\">\nEdgarTools is distributed under the <a href=\"LICENSE\">MIT License<\/a>\n<\/p>\n\n## Star History\n\n[![Star History Chart](https:\/\/api.star-history.com\/svg?repos=dgunning\/edgartools&type=Timeline)](https:\/\/star-history.com\/#dgunning\/edgartools&Timeline)\n\n<!-- mcp-name: io.github.dgunning\/edgartools -->\n","description_content_type":"text\/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":"10-K, 10-Q, 13F, 8-K, annual report, company filings, edgar, edgar api, edgar filings, filings, finance, financial data, financial statements, form 4, insider trading, institutional holdings, python, quarterly report, sec, sec api, sec filings, stock filings, xbrl","license":null,"license_expression":"MIT","license_files":["LICENSE.txt"],"maintainer":null,"maintainer_email":null,"name":"edgartools","package_url":"https:\/\/pypi.org\/project\/edgartools\/","platform":null,"project_url":"https:\/\/pypi.org\/project\/edgartools\/","project_urls":{"Changelog":"https:\/\/github.com\/dgunning\/edgartools\/releases","Documentation":"https:\/\/dgunning.github.io\/edgartools\/","Homepage":"https:\/\/github.com\/dgunning\/edgartools","Issues":"https:\/\/github.com\/dgunning\/edgartools\/issues","Source":"https:\/\/github.com\/dgunning\/edgartools"},"provides_extra":["ai","ai-dev","all-cloud","azure","cloud","data","gcs","s3","test-harness"],"release_url":"https:\/\/pypi.org\/project\/edgartools\/5.61.1\/","requires_dist":["beautifulsoup4>=4.10.0","httpx<0.29,>=0.25.0","httpxthrottlecache[httpx]>=0.6.1","humanize>=4.0.0","jinja2>=3.1.6","lxml>=6.1.0","nest-asyncio>=1.5.1","orjson>=3.11.6","pandas>=2.0.0","pyarrow>=23.0.1","pydantic>=2.4.0","pyrate-limiter>=3.0.0","rank-bm25>=0.2.1","rapidfuzz>=3.5.0","rich>=13.8.0","stamina>=24.2.0","tabulate>=0.9.0","textdistance>=4.5.0","tqdm>=4.66.3","truststore>=0.9.0","unidecode>=1.2.0","mcp<2.0.0,>=1.28.1; extra == \"ai\"","starlette>=1.3.1; extra == \"ai\"","tiktoken>=0.10.0; extra == \"ai\"","uvicorn>=0.27.0; extra == \"ai\"","pytest-mock>=3.12.0; extra == \"ai-dev\"","responses>=0.24.0; extra == \"ai-dev\"","adlfs>=2023.1.0; extra == \"all-cloud\"","fsspec>=2023.1.0; extra == \"all-cloud\"","gcsfs>=2023.1.0; extra == \"all-cloud\"","s3fs>=2023.1.0; extra == \"all-cloud\"","adlfs>=2023.1.0; extra == \"azure\"","fsspec>=2023.1.0; extra == \"azure\"","fsspec>=2023.1.0; extra == \"cloud\"","duckdb>=1.0.0; extra == \"data\"","zstandard>=0.20.0; extra == \"data\"","fsspec>=2023.1.0; extra == \"gcs\"","gcsfs>=2023.1.0; extra == \"gcs\"","fsspec>=2023.1.0; extra == \"s3\"","s3fs>=2023.1.0; extra == \"s3\"","click>=8.0.0; extra == \"test-harness\""],"requires_python":">=3.10","summary":"Python library to access and analyze SEC Edgar filings, XBRL financial statements, 10-K, 10-Q, and 8-K reports","version":"5.61.1","yanked":false,"yanked_reason":null},"last_serial":43806061,"ownership":{"organization":null,"roles":[{"role":"Owner","user":"dwgunning"}]},"urls":[{"comment_text":null,"core-metadata":{"sha256":"ccfefcbf0763924e00bb168b29c8140a36ccd943c1eff09489390cb5a2c8b144"},"digests":{"blake2b_256":"9ec110e2baaeb32364a7147a181de1d22cc1e74eaefb57d54a1aaabfe7e95074","md5":"db89d12cd9613b652e43cd868c2dfd13","sha256":"8229753d3fb4dfdc865291bf7fd684d11297094b88ec724c919630cf21e81037"},"downloads":-1,"filename":"edgartools-5.61.1-py3-none-any.whl","has_sig":false,"md5_digest":"db89d12cd9613b652e43cd868c2dfd13","packagetype":"bdist_wheel","python_version":"py3","requires_python":">=3.10","size":3555266,"upload_time":"2026-10-06T22:29:25","upload_time_iso_8601":"2026-10-06T22:29:25.305633Z","url":"https:\/\/files.pythonhosted.org\/packages\/9e\/c1\/10e2baaeb32364a7147a181de1d22cc1e74eaefb57d54a1aaabfe7e95074\/edgartools-5.61.1-py3-none-any.whl","yanked":false,"yanked_reason":null},{"comment_text":null,"core-metadata":false,"digests":{"blake2b_256":"2be2e5015733b023d3beb1ecd7e98e9ffd034e312218cffe6a779fdab94ba9d5","md5":"ad0e9372694c5728892fecaafe77f1b3","sha256":"4acbe0c7be55fcd007d4d1c2f2fc679221b28cbdb9a7b5d7fc773b71719eab6a"},"downloads":-1,"filename":"edgartools-5.61.1.tar.gz","has_sig":false,"md5_digest":"ad0e9372694c5728892fecaafe77f1b3","packagetype":"sdist","python_version":"source","requires_python":">=3.10","size":3251363,"upload_time":"2026-10-06T22:29:27","upload_time_iso_8601":"2026-10-06T22:29:27.807883Z","url":"https:\/\/files.pythonhosted.org\/packages\/2b\/e2\/e5015733b023d3beb1ecd7e98e9ffd034e312218cffe6a779fdab94ba9d5\/edgartools-5.61.1.tar.gz","yanked":false,"yanked_reason":null}],"vulnerabilities":[]}