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.361.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.361-py3-none-any.whl (1.6 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: datamule-0.361.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.361.tar.gz
Algorithm Hash digest
SHA256 1d6b74d23e7bdac4e49ed9038912957981a956c55807e73ab23f1e0a8f9dca85
MD5 53fff139fdf37f23acbb3f9a9f2dd017
BLAKE2b-256 c69cd8dc0a36cd82f5ef73b6fc8e2cd3fbccf2fff24a1064bbbc36464d517244

See more details on using hashes here.

File details

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

File metadata

  • Download URL: datamule-0.361-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.361-py3-none-any.whl
Algorithm Hash digest
SHA256 ecacbd44411e3946feffd2a551c545d9bd308c095ee6bfc6d07bc18cc2801c24
MD5 dddc5987358c547d4f5da82cfeec7a34
BLAKE2b-256 89d5c989b73227f86601714d9a3b55d22662af9fc0e7a093958591908c7faf93

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