Skip to main content

Making it easier to use SEC filings.

Project description

datamule

PyPI - Downloads Hits GitHub

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 | 📝 Article: Deploy a Financial Chatbot in 5 Minutes

Key Features

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

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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

datamule-0.360.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

datamule-0.360-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

File details

Details for the file datamule-0.360.tar.gz.

File metadata

  • Download URL: datamule-0.360.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.5

File hashes

Hashes for datamule-0.360.tar.gz
Algorithm Hash digest
SHA256 1b614c314a297a86ebcb71bdf5b7b4fadf563d99ec4abd574d399e65c3c840b7
MD5 299db9a772b8b01aeaa4348144ee7d69
BLAKE2b-256 e8fe8b6983c4ee32f513752234764b937267d1a045edbe718efb70dd31e81d17

See more details on using hashes here.

File details

Details for the file datamule-0.360-py3-none-any.whl.

File metadata

  • Download URL: datamule-0.360-py3-none-any.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.5

File hashes

Hashes for datamule-0.360-py3-none-any.whl
Algorithm Hash digest
SHA256 d121b5de2aa3c5b171f379981cb5fb7d869a9fe882b13ab2925ccaee31b8ac82
MD5 380d0abb5aa222a6cc276a3f4eb3585c
BLAKE2b-256 971175d45a6349f5c0d746eb76f51291ede4cedba2352f20a0992ff6d9b17605

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page