Skip to main content

Making it easier to use SEC filings.

Project description

Datamule

Major Update

Datamule has undergone a significant rework and is no longer backwards compatible. If this has affected your workflow please post on the github issues megathread. Sorry for the inconvenience.

.. image:: https://static.pepy.tech/badge/datamule :target: https://pepy.tech/project/datamule :alt: Downloads

.. image:: https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fjohn-friedman%2Fdatamule-python&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false :target: https://hits.seeyoufarm.com :alt: Hits

.. image:: https://img.shields.io/github/stars/john-friedman/datamule-python :alt: GitHub Stars

A Python package for working with SEC filings at scale. Full Documentation <https://john-friedman.github.io/datamule-python/>_ | Website <https://datamule.xyz/>_

Features

  • Download SEC filings quickly and efficiently <https://john-friedman.github.io/datamule-python/usage/downloader.html>_
  • Monitor EDGAR for new filings in real-time <https://john-friedman.github.io/datamule-python/usage/monitor.html>_
  • Parse filings at scale <https://john-friedman.github.io/datamule-python/usage/parsing.html>_
  • Access comprehensive datasets (10-Ks, SIC codes, etc.) <https://john-friedman.github.io/datamule-python/usage/datasets.html>_
  • Build datasets directly from unstructured text <https://john-friedman.github.io/datamule-python/usage/dataset_builder.html>_
  • Interact with SEC data using MuleBot <https://john-friedman.github.io/datamule-python/usage/mulebot.html>_

Quick Start

Basic Installation


.. code-block:: bash

    pip install datamule

Installation with all extras

.. code-block:: bash

pip install datamule[all]

Download submissions example


.. code-block:: python

    from datamule import Downloader

    downloader = Downloader()
    downloader.download_submissions(form='10-K', ticker='AAPL')

Articles
--------
* `How to host the SEC Archive for $20/month <https://medium.com/@jgfriedman99/how-to-host-the-sec-archive-for-20-month-da374cc3c3fb>`_
* `Creating Structured Datasets from SEC filings <https://medium.com/@jgfriedman99/how-to-create-alternative-datasets-using-datamule-d3a0192da8f6>`_
* `Deploy a Financial Chatbot in 5 Minutes <https://medium.com/@jgfriedman99/how-to-deploy-a-financial-chatbot-in-5-minutes-ef5eec973d4c>`_

Contributing
------------

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

License
-------

`MIT License <LICENSE>`_

----

For detailed usage examples, API reference, and advanced features, please visit our `documentation <https://john-friedman.github.io/datamule-python/>`_.

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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

datamule-0.410-cp311-cp311-win_amd64.whl (1.7 MB view details)

Uploaded CPython 3.11Windows x86-64

datamule-0.410-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

datamule-0.410-cp311-cp311-macosx_10_9_universal2.whl (1.8 MB view details)

Uploaded CPython 3.11macOS 10.9+ universal2 (ARM64, x86-64)

datamule-0.410-cp310-cp310-win_amd64.whl (1.7 MB view details)

Uploaded CPython 3.10Windows x86-64

datamule-0.410-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.0 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

datamule-0.410-cp310-cp310-macosx_10_9_universal2.whl (1.8 MB view details)

Uploaded CPython 3.10macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file datamule-0.410-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: datamule-0.410-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.7 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.11

File hashes

Hashes for datamule-0.410-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 ee46dc94cfd089cac221e8f19eb852d1839372ed5e00d8ffeb52497776c5911a
MD5 0b4c09b86eb1e071c767def2c5e030f5
BLAKE2b-256 1c8ab48c9f911ac8bd80510c412c0fd87c38a8f876b9402d8d177bb19aa524cb

See more details on using hashes here.

File details

Details for the file datamule-0.410-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for datamule-0.410-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 b1fb4a5898732b01f9f693dd4e94d3e9e2981147ef0beba7e6498896c9ee0827
MD5 aefc7ff126c77a8cbbf4b4d8e7076d54
BLAKE2b-256 88d22463637d84856c3961a803630b03a080940cadb8edd5d1b52bfd31dafa6a

See more details on using hashes here.

File details

Details for the file datamule-0.410-cp311-cp311-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for datamule-0.410-cp311-cp311-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 925b119b1c94b1e41de7c20e82ebf0861652797a868a3f4f54fb9cf27ed67f08
MD5 d46c3ae8b8d0bdf5b8f1c4806d56b07b
BLAKE2b-256 01cb66f7e863fa38bd84f000c9fde02d7f6375e64af59d43a5cf832a5ef67d5c

See more details on using hashes here.

File details

Details for the file datamule-0.410-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: datamule-0.410-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 1.7 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.11

File hashes

Hashes for datamule-0.410-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 63885627141235089f7e41d0ddaa04a1168e5de07999fe3db8b05de3096ab1b4
MD5 2547e41ebd55ac54c82b535ead324383
BLAKE2b-256 a9aad75cbdf5911f69481cc2ccd70dbeeb91129fdf2090c5ba724742aaed75bd

See more details on using hashes here.

File details

Details for the file datamule-0.410-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for datamule-0.410-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ecdff19070e65d574242ef0a01066691873770b1fd2f852895e7fa0db5248e02
MD5 161cf17614e3715e757f464a7c31a603
BLAKE2b-256 a36444715439930e412a891ff7afde5bf6b174203e38b9d76655b644a4c6d5b4

See more details on using hashes here.

File details

Details for the file datamule-0.410-cp310-cp310-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for datamule-0.410-cp310-cp310-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 068ddf7daaaf46b16b8ac678b495ecf0600e95171a5b31b53d1b10696711ef52
MD5 a729015153951542d27fa86722fc3ae0
BLAKE2b-256 622480eacb4c8acbfe0012b28cb107ef278b265ea872b194aafd3393aaf94596

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