datamule

A Python package for working with SEC filings at scale. Includes Mulebot, an open-source chatbot for SEC data with no storage requirements. 📚 Full Documentation | 🌐 Website

Articles:

• Article: Creating Structured Datasets from SEC filings
• Article: Deploy a Financial Chatbot in 5 Minutes

Key Features

• 📥 Download SEC filings quickly and efficiently
• 🔍 Monitor EDGAR for new filings in real-time
• 📊 Parse filings at scale
• 💾 Access comprehensive datasets (10-Ks, SIC codes, etc.)
• 🤖 Interact with SEC data using MuleBot

Quick Start

# Basic installation
pip install datamule

# Install with all features
pip install datamule[all]

import datamule as dm

# Download filings
downloader = dm.Downloader()
downloader.download(form='10-K', ticker='AAPL')

# Download filing attachments such as information tables
downloader.download(form='13F-HR',file_types=['INFORMATION TABLE'],date=('2024-09-14','2024-09-16'))

# Download every 10Q from 2023. Should take 2 minutes
downloader.download_dataset(dataset='10q_2023')

Available Extras

• filing_viewer: Filing viewer module
• mulebot: SEC data interaction chatbot
• mulebot_server: Flask server for MuleBot
• all: All available features

Resources

• 📊 SEC Filing Glossary
• 📈 XBRL Fact Glossary
• 🤖 Try MuleBot

Datasets

Access comprehensive SEC datasets including:

• Historical FTD data (since 2004)
• 10-K and 10-Q filings (since 2001)
• 13F-HR Information Tables (since 2013)
• MD&A collection (100,000+ since 2001, requires free API key)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

For detailed usage examples, API reference, and advanced features, please visit our documentation.