filingpulse

Python client for the FilingPulse API — real-time SEC EDGAR filings (Form 4 insider transactions, 8-K corporate events, S-1/IPO registration lifecycle) 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)

# S-1/IPO registration lifecycle — follow one offering by SEC file number
for ev in fp.registrations(stage="registration", limit=20)["data"]:
    print(ev["issuer"]["name"], ev["form_type"], ev["file_number"])
offering = fp.registrations(file_number="333-296288")  # all stages of one offering

# 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.

TLS certificate errors

If you see certificate verify failed: certificate has expired, the cause is almost certainly a stale root store on your machine, not our certificate — some Windows installs and locked-down corporate images carry an outdated root list that rejects current Let's Encrypt chains. This client uses certifi's roots automatically whenever it is importable (pip install certifi), and falls back to your OS trust store otherwise, so the package remains dependency-free.

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.