Metadata-Version: 2.4
Name: filingpulse
Version: 0.1.0
Summary: Real-time normalized SEC EDGAR filings: Form 4 insider transactions and 8-K events as clean JSON. Data infrastructure — not investment advice.
Project-URL: Homepage, https://filingpulse.io
Project-URL: Documentation, https://filingpulse.io/docs.html
License-Expression: MIT
Keywords: 8-k,api,edgar,filings,form4,insider-transactions,sec
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# filingpulse

Python client for the [FilingPulse](https://filingpulse.io) API — real-time SEC EDGAR filings
(Form 4 insider transactions, 8-K corporate events) normalized to one stable JSON schema.
Zero dependencies.

```python
from filingpulse import FilingPulse

fp = FilingPulse(api_key="fp_your_key")

# Recent insider transactions at a company
for filing in fp.insider_trades(ticker="KMI", since="2026-07-01")["data"]:
    owner = filing["reporting_owners"][0]["name"]
    for tx in filing["transactions"]:
        print(owner, tx["transaction_code"], tx["shares"])

# Earnings 8-Ks
earnings = fp.events(item="2.02", limit=20)

# Real-time webhooks: filing lands -> signed JSON hits your endpoint
hook = fp.create_webhook("https://example.com/hook",
                         events=["form4"], filters={"tickers": ["KMI"]})
print(hook["secret"])  # shown once — store it

# Verify deliveries in your handler
from filingpulse import verify_webhook_signature
ok = verify_webhook_signature(secret, request_body_bytes,
                              request.headers["X-FilingPulse-Signature"])
```

Errors are typed: `AuthError` (401), `NotFoundError` (404), `RateLimitError` (429, has
`.retry_after`), all subclassing `FilingPulseError`.

FilingPulse is **data infrastructure**: it reports what was filed with the SEC. Nothing in
this package or API is investment advice, a signal, or a recommendation.
