/datamule-python

A package to work with SEC data. Incorporates datamule endpoints.

Primary LanguagePythonMIT LicenseMIT

datamule

Downloads GitHub Stars

A python package for working with SEC filings at scale. Integrated with datamule's endpoints.

Datamule's Endpoints (requires API Key)

I host a bunch of useful stuff in the cloud, such as:

  • SEC Websocket (Free)
  • SEC Archive without rate limits ($1/100,000 downloads)
  • SEC MySQL RDS ($1/million rows retrieved)
    • SEC XBRL
    • Company Fundamentals
    • Proxy Voting Records: (N-PX)
    • Institutional Holdings: (13F-HR)
    • Insider Transactions: (3,4,5)

Pricing is meant to cover usage + if I make money that's cool.

Get an API Key

All cloud resources are built using this package. This package is under the MIT License. You are 100% allowed to use this package to create your own commercial offerings. If you do, please let me know! I think it's neat.

Related:

Packages

  • datamule-data Contains datasets for use with datamule-python
  • datamule-indicators Create economic indicators from SEC filings
  • txt2dataset Create datasets from unstructured text
  • secsgml Parse SEC filings in SGML format
  • doc2dict Convert documents to dictionaries.
  • secxbrl Fast, lightweight parser designed for SEC InLine XBRL.

Articles/Cloud

Installation

pip install datamule

Quickstart

from datamule import Portfolio
portfolio = Portfolio('apple')
portfolio.download_submissions(ticker='AAPL',submission_type='10-K')

Providers

You can use the sec (default) or datamule (no rate limit) which requires an api key.

Disclaimer

This package almost certainly solves your use case or will solve your use case soon.

However, the docs are incomplete. Feel free to post a github issue or email me for clarification. I reply quickly, and this helps me improve the documentation.