filingpulse 0.1.0

Real-time normalized SEC EDGAR filings: Form 4 insider transactions and 8-K events as clean JSON. Data infrastructure — not investment advice.

filingpulse

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

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.