form4api 0.7.0__tar.gz → 0.8.0__tar.gz

{form4api-0.7.0/form4api.egg-info → form4api-0.8.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: form4api
-Version: 0.7.0
-Summary: Python client for the Form4API — real-time SEC Form 4 insider trading data
+Version: 0.8.0
+Summary: Python client for the Form4API — real-time SEC Form 4 insider trading, Form 144 intent-to-sell, institutional 13F-HR, and congressional STOCK Act trading data, including the insider/Congress convergence signal
 License-Expression: MIT
 Project-URL: Homepage, https://www.form4api.com
 Project-URL: Documentation, https://www.form4api.com/docs
 Project-URL: Repository, https://github.com/theodor90/form4api-py.git
-Keywords: insider-trading,sec,sec-edgar,edgar,form-4,form4,form-144,13f,13f-hr,financial-data,stock-market,stocks,fintech,api,sdk,webhooks,form4api
+Keywords: insider-trading,sec,sec-edgar,edgar,form-4,form4,form-144,13f,13f-hr,congress,stock-act,financial-data,stock-market,stocks,fintech,api,sdk,webhooks,form4api
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -19,7 +19,7 @@ Dynamic: license-file
 
 # form4api
 
-Python client for [Form4API](https://www.form4api.com) — real-time SEC Form 4 insider trading data.
+Python client for [Form4API](https://www.form4api.com) — real-time SEC Form 4 insider trading, Form 144 intent-to-sell, institutional 13F-HR, and congressional STOCK Act trading data, including the insider/Congress convergence signal.
 
 [![PyPI version](https://img.shields.io/pypi/v/form4api.svg)](https://pypi.org/project/form4api/)
 [![PyPI downloads](https://img.shields.io/pypi/dm/form4api.svg)](https://pypi.org/project/form4api/)
@@ -108,16 +108,21 @@ For LLM workflows, `form4api-mcp` exposes the same endpoints as tools.
 
 ```python
 client.transactions.list(
-    ticker="AAPL",        # filter by ticker
+    ticker="AAPL",        # filter by ticker — accepts up to 25 comma-separated symbols
     cik="0000320193",     # or by company CIK
     insider_cik="...",    # filter by insider CIK
     code="P",             # transaction code: P=purchase, S=sale, A=grant, etc.
     from_date="2026-01-01",
     to_date="2026-12-31",
+    filed_from="2026-01-01",  # filters on Filing.FiledAt (when it hit EDGAR), not the trade date
+    filed_to="2026-12-31",
     exclude_10b5=True,    # omit trades filed under a Rule 10b5-1 plan
     per_page=100,
     page=1,
 )
+
+# Multi-ticker lookup in one call
+client.transactions.list(ticker="AAPL,MSFT,NVDA")
 ```
 
 ### Granular filtering (v0.4.0+)
@@ -166,6 +171,11 @@ client.transactions.list(min_shares=10_000, max_shares=100_000)
 | `is_derivative` | `bool` | Derivative security flag |
 | `transaction_date` | `str` | ISO datetime |
 | `period_of_report` | `str` | ISO datetime |
+| `return1d`/`return1w`/`return1m`/`return3m`/`return6m` | `float \| None` | Forward return since the transaction date, as a fraction (0.109 = +10.9%); `None` until enough time/price data has elapsed |
+| `value_quality` | `str \| None` | Confidence flag on `total_value`'s pricing source |
+| `accepted_at` | `str \| None` | Precise UTC SEC-acceptance instant; `None` if not captured |
+| `document_url` | `str \| None` | Public SEC document URL |
+| `institutional_ownership` | `InstitutionalOwnership \| None` | Latest 13F institutional ownership snapshot for the ticker, when available |
 
 ### Company fields
 

form4api-0.7.0/PKG-INFO → form4api-0.8.0/README.md

@@ -1,25 +1,6 @@
-Metadata-Version: 2.4
-Name: form4api
-Version: 0.7.0
-Summary: Python client for the Form4API — real-time SEC Form 4 insider trading data
-License-Expression: MIT
-Project-URL: Homepage, https://www.form4api.com
-Project-URL: Documentation, https://www.form4api.com/docs
-Project-URL: Repository, https://github.com/theodor90/form4api-py.git
-Keywords: insider-trading,sec,sec-edgar,edgar,form-4,form4,form-144,13f,13f-hr,financial-data,stock-market,stocks,fintech,api,sdk,webhooks,form4api
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx>=0.27
-Provides-Extra: dev
-Requires-Dist: pytest>=8; extra == "dev"
-Requires-Dist: pytest-httpx>=0.30; extra == "dev"
-Requires-Dist: respx>=0.21; extra == "dev"
-Dynamic: license-file
-
 # form4api
 
-Python client for [Form4API](https://www.form4api.com) — real-time SEC Form 4 insider trading data.
+Python client for [Form4API](https://www.form4api.com) — real-time SEC Form 4 insider trading, Form 144 intent-to-sell, institutional 13F-HR, and congressional STOCK Act trading data, including the insider/Congress convergence signal.
 
 [![PyPI version](https://img.shields.io/pypi/v/form4api.svg)](https://pypi.org/project/form4api/)
 [![PyPI downloads](https://img.shields.io/pypi/dm/form4api.svg)](https://pypi.org/project/form4api/)
@@ -108,16 +89,21 @@ For LLM workflows, `form4api-mcp` exposes the same endpoints as tools.
 
 ```python
 client.transactions.list(
-    ticker="AAPL",        # filter by ticker
+    ticker="AAPL",        # filter by ticker — accepts up to 25 comma-separated symbols
     cik="0000320193",     # or by company CIK
     insider_cik="...",    # filter by insider CIK
     code="P",             # transaction code: P=purchase, S=sale, A=grant, etc.
     from_date="2026-01-01",
     to_date="2026-12-31",
+    filed_from="2026-01-01",  # filters on Filing.FiledAt (when it hit EDGAR), not the trade date
+    filed_to="2026-12-31",
     exclude_10b5=True,    # omit trades filed under a Rule 10b5-1 plan
     per_page=100,
     page=1,
 )
+
+# Multi-ticker lookup in one call
+client.transactions.list(ticker="AAPL,MSFT,NVDA")
 ```
 
 ### Granular filtering (v0.4.0+)
@@ -166,6 +152,11 @@ client.transactions.list(min_shares=10_000, max_shares=100_000)
 | `is_derivative` | `bool` | Derivative security flag |
 | `transaction_date` | `str` | ISO datetime |
 | `period_of_report` | `str` | ISO datetime |
+| `return1d`/`return1w`/`return1m`/`return3m`/`return6m` | `float \| None` | Forward return since the transaction date, as a fraction (0.109 = +10.9%); `None` until enough time/price data has elapsed |
+| `value_quality` | `str \| None` | Confidence flag on `total_value`'s pricing source |
+| `accepted_at` | `str \| None` | Precise UTC SEC-acceptance instant; `None` if not captured |
+| `document_url` | `str \| None` | Public SEC document URL |
+| `institutional_ownership` | `InstitutionalOwnership \| None` | Latest 13F institutional ownership snapshot for the ticker, when available |
 
 ### Company fields
 

{form4api-0.7.0 → form4api-0.8.0}/form4api/__init__.py

@@ -11,6 +11,8 @@ from form4api._types import (
     Company,
     Insider,
     InsiderSignal,
+    InstitutionalOwnership,
+    TopHolder,
     Transaction,
     WebhookCreated,
     WebhookEvent,
@@ -31,6 +33,8 @@ __all__ = [
     "Insider",
     "Company",
     "InsiderSignal",
+    "InstitutionalOwnership",
+    "TopHolder",
     "WebhookCreated",
     "WebhookEvent",
     "WebhookSubscription",