EdgarTools - Python Library for SEC EDGAR Filings

The simplest, most complete Python library for SEC EDGAR data

Get financial statements, insider trades, fund holdings, and 20+ other filing types as structured Python objects — in a few lines of code. Free and open source.

EdgarTools is a Python library for accessing SEC EDGAR filings as structured data. Parse financial statements, insider trades, fund holdings, proxy statements, and dozens of other filing types with a consistent Python API.

Why EdgarTools?

EdgarTools turns SEC filings into Python objects. Every supported form type gives you structured data — not raw HTML, not XML, not JSON dumps. Actual Python objects with properties, methods, and DataFrames.

Fast Optimized with lxml & PyArrow Smart caching, rate-limit aware	AI Ready Built-in MCP server for Claude LLM-optimized text extraction	Well Tested 1000+ verification tests Type hints throughout
XBRL Native Full XBRL standardization Cross-company comparisons	20+ Filing Types Typed objects for every form Pandas-ready DataFrames	Open Source MIT license, free forever No API keys, no rate limits

How It Works

pip install edgartools

from edgar import *
set_identity("your.name@example.com")

# Get a company's balance sheet
balance_sheet = Company("AAPL").get_financials().balance_sheet()

# Browse a company's filings
company = Company("MSFT")

# Parse insider transactions
filings = company.get_filings(form="4")
form4 = filings[0].obj()

Use Cases

Analyze 13F Institutional Holdings & Hedge Fund Portfolios

Track what hedge funds and institutional investors own by parsing SEC 13F filings. EdgarTools extracts complete portfolio holdings with position sizes, values, and quarter-over-quarter changes.

from edgar import get_filings
thirteenf = get_filings(form="13F-HR")[0].obj()
thirteenf.holdings  # DataFrame of all portfolio positions

Institutional Holdings guide →

Track Insider Trading with SEC Form 4

Monitor insider buying and selling activity from SEC Form 4 filings. See which executives are purchasing or selling shares, option exercises, and net position changes.

company = Company("TSLA")
form4 = company.get_filings(form="4")[0].obj()
form4.transactions  # Insider buy/sell transactions

Insider Trades guide →

Extract Financial Statements from 10-K and 10-Q Filings

Get income statements, balance sheets, and cash flow statements from SEC annual and quarterly reports. Data is parsed from XBRL with standardized labels for cross-company comparison.

financials = Company("MSFT").get_financials()
financials.balance_sheet()   # Balance sheet with all line items
financials.income_statement()  # Revenue, net income, EPS

Financial Statements guide →

Parse 8-K Current Reports for Corporate Events

Access material corporate events as they happen -- earnings releases, acquisitions, executive changes, and more. EdgarTools parses 8-K filings into structured items with full text extraction.

eightk = get_filings(form="8-K")[0].obj()
eightk.items  # List of reported event items

Current Events guide →

Query XBRL Financial Data Across Companies

Access structured XBRL financial facts for any SEC filer. Query specific line items like revenue or total assets over time, and compare across companies using standardized concepts.

facts = Company("AAPL").get_facts()
facts.to_pandas("us-gaap:Revenues")  # Revenue history as DataFrame

XBRL Deep Dive →

Comprehensive SEC Data Access

Financial Statements (XBRL) Balance Sheets, Income Statements, Cash Flows Individual line items via XBRL tags Multi-period comparisons with comparative periods Standardized cross-company data Automatic unit conversion Metadata columns (dimensions, members, units) Complete dimensional data support Fund & Investment Data 13F institutional holdings & portfolio analysis N-PORT fund portfolio data N-MFP money market fund holdings N-CSR/N-CEN fund reports Position tracking over time Company Dataset & Reference Data Industry and state filtering Company subsets with metadata Standardized industry classifications SEC ticker/CIK lookups Exchange information Insider Transactions Form 3, 4, 5 structured data Transaction history by insider Ownership changes Grant and exercise details Automatic parsing

Filing Intelligence Any form type (10-K, 10-Q, 8-K, S-1, etc.) Complete history since 1994 Typed data objects for 20+ form types HTML to clean text extraction Section extraction (Risk Factors, MD&A) Subsidiaries (EX-21) and auditor extraction Performance & Reliability Configurable rate limiting (enterprise mirrors supported) Custom SEC data sources (corporate/academic mirrors) Smart caching (30-second fresh filing cache) Robust error handling SSL verification with fail-fast retry Type hints throughout Enterprise configuration → Developer Experience Intuitive, consistent API Pandas DataFrame integration Rich terminal output 1000+ tests

EdgarTools 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.

Comparison with Alternatives

Feature	EdgarTools	sec-api (paid)	Manual
Cost	Free	$150+/mo	Free
Filing types parsed	20+ typed objects	~5	DIY
XBRL Support	Full	Partial	None
Financial Statements	Parsed + standardized	Parsed	DIY
Fund Data (13F, N-PORT, N-MFP)
Insider Trades (Form 4)	Structured		DIY
AI/MCP Integration
Open Source	MIT	Proprietary	N/A

Use EdgarTools with Claude Code & Claude Desktop

EdgarTools 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.

• "Compare Apple and Microsoft's revenue growth rates over the past 3 years"
• "Which Tesla executives sold more than $1 million in stock in the past 6 months?"

Setup Instructions

Option 1: AI Skills (Recommended)

Install the EdgarTools skill for Claude Code or Claude Desktop:

pip install "edgartools[ai]"
python -c "from edgar.ai import install_skill; install_skill()"

This adds SEC analysis capabilities to Claude, including 3,450+ lines of API documentation, code examples, and form type reference.

Option 2: MCP Server

Run EdgarTools as an MCP server for any AI client -- Claude Desktop, Cline, or your own containerized deployment.

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "edgartools": {
      "command": "uvx",
      "args": ["--from", "edgartools[ai]", "edgartools-mcp"],
      "env": {
        "EDGAR_IDENTITY": "Your Name your.email@example.com"
      }
    }
  }
}

Requires uv. Alternatively, pip install "edgartools[ai]" and use python -m edgar.ai.

See AI Integration Guide for complete documentation.

Support This Project

EdgarTools replaces hundreds of hours of SEC parsing work — and it costs nothing to use. No API keys, no subscriptions, no rate limits. Free infrastructure for anyone working with SEC data.

But it doesn't maintain itself. The SEC updates filing formats every year. XBRL taxonomies change. New form types appear. One maintainer keeps all of it working, and your support makes that sustainable.

Sponsors aren't just giving back — you're investing in a shared resource and helping shape what gets built next.

  

What your support enables:

• Continued maintenance as SEC formats evolve
• New filing types and data objects
• Fast bug fixes and community support
• Free access for everyone, forever

Corporate sponsors: If your team depends on EdgarTools for compliance, financial analysis, or data pipelines, GitHub Sponsors offers tiers designed for organizations with mission-critical dependencies.

Documentation & Resources

• Documentation
• Notebooks / Examples
• Quick Guide
• EdgarTools Blog

Get Help & Connect

• GitHub Issues - Bug reports and feature requests
• Discussions - Questions and community discussions

Contributing

Contributions welcome:

• Code: Fix bugs, add features, improve documentation
• Examples: Share interesting use cases and examples
• Feedback: Report issues or suggest improvements
• Spread the Word: Star the repo, share with colleagues

See our Contributing Guide for details.

---

EdgarTools is distributed under the MIT License

Star History