added Form 144 API - restricted stock sales notifications

Author: janlukasschroeder

README.md

@@ -23,6 +23,7 @@
 **Ownership Data APIs**
 
 - [Form 3/4/5 API - Insider Trading Disclosures](#insider-trading-data-api)
+- [Form 144 API - Restricted Stock Sales by Insiders](#form-144-api)
 - [Form 13F API - Institutional Investment Manager Holdings & Cover Pages](#form-13f-institutional-holdings-database)
 - [Form 13D/13G API - Activist and Passive Investor Holdings](#form-13d-13g-api)
 - [Form N-PORT API - Mutual Funds, ETFs and Closed-End Fund Holdings](#form-n-port-api)
@@ -700,6 +701,29 @@ print(insider_trades["transactions"])
 ]
 ```
 
+## Form 144 API
+
+The Form 144 API allows you to search and access all Form 144 filings from 2022 to present. Form 144 filings are filed with the SEC by corporate insiders who intend to sell restricted securities, such as vested stocks. The database includes information about the CIK and name of the insider, the issuer name and trading symbol, number of shares intended to be sold, the date of the transaction, the total value of the transaction, and more.
+
+```python
+from sec_api import Form144Api
+
+form144Api = Form144Api("YOUR_API_KEY")
+
+search_params = {
+    "query": "entities.ticker:TSLA",
+    "from": "0",
+    "size": "50",
+    "sort": [{"filedAt": {"order": "desc"}}],
+}
+
+response = form144Api.get_data(search_params)
+
+print(response["data"])
+```
+
+> See the documentation for more details: https://sec-api.io/docs/form-144-restricted-sales-api
+
 ## Form 13F Institutional Holdings Database
 
 Access Form 13F holdings in structured JSON format, including information on current and historical portfolio holdings of SEC-registered funds and investment managers, including issuer name, title of the securities class, CUSIP, CIK and ticker of the holding, value of the position in dollar, the number of shares held, investment discretion, voting authority, and more.

examples.py

@@ -7,6 +7,7 @@
     FormAdvApi,
     #
     InsiderTradingApi,
+    Form144Api,
     Form13FHoldingsApi,
     Form13FCoverPagesApi,
     FormNportApi,
@@ -219,6 +220,25 @@
 # """
 
 
+#
+# Form 144 API Example
+#
+"""
+form144Api = Form144Api("YOUR_API_KEY")
+
+search_params = {
+    "query": "entities.ticker:TSLA",
+    "from": "0",
+    "size": "1",
+    "sort": [{"filedAt": {"order": "desc"}}],
+}
+
+response = form144Api.get_data(search_params)
+
+print(response["data"])
+# """
+
+
 #
 # Form 13F Holdings API Example
 #

sec_api/__init__.py

@@ -10,6 +10,7 @@
 
 # Ownership APIs
 from sec_api.index import InsiderTradingApi
+from sec_api.index import Form144Api
 from sec_api.index import Form13FHoldingsApi
 from sec_api.index import Form13FCoverPagesApi
 from sec_api.index import FormNportApi

sec_api/index.py

@@ -13,6 +13,7 @@
 form_adv_endpoint = "https://api.sec-api.io/form-adv"
 #
 insider_api_endpoint = "https://api.sec-api.io/insider-trading"
+form_144_api_endpoint = "https://api.sec-api.io/form-144"
 form_13F_holdings_endpoint = "https://api.sec-api.io/form-13f/holdings"
 form_13F_cover_pages_endpoint = "https://api.sec-api.io/form-13f/cover-pages"
 form_nport_api_endpoint = "https://api.sec-api.io/form-nport"
@@ -434,6 +435,34 @@ def get_data(self, query):
             handle_api_error(response)
 
 
+class Form144Api:
+    """
+    Base class for Form 144 API
+    https://sec-api.io/docs/form-144-restricted-sales-api
+    """
+
+    def __init__(self, api_key, proxies=None):
+        self.api_key = api_key
+        self.api_endpoint = form_144_api_endpoint + "?token=" + api_key
+        self.proxies = proxies if proxies else {}
+
+    def get_data(self, query):
+        response = {}
+
+        for x in range(3):
+            response = requests.post(
+                self.api_endpoint, json=query, proxies=self.proxies
+            )
+            if response.status_code == 200:
+                return response.json()
+            elif response.status_code == 429:
+                time.sleep(0.5 * (x + 1))
+            else:
+                handle_api_error(response)
+        else:
+            handle_api_error(response)
+
+
 class Form13FHoldingsApi:
     """
     Base class for Form 13F Holdings API

setup.py

@@ -5,7 +5,7 @@
 
 setup(
     name="sec-api",
-    version="1.0.30",
+    version="1.0.31",
     author="SEC API",
     author_email="support@sec-api.io",
     description="SEC EDGAR Filings API",