공시 정리 격차 해소
스크레이퍼를 소유하지 않고.

webhook_handler.py · FastAPI

import os
from fastapi import Depends, FastAPI
from openfilings import Client
from openfilings.integrations.fastapi import openfilings_webhook_dependency
from openfilings.webhooks import WebhookEvent

app = FastAPI()
client = Client(api_key=os.environ["OPENFILINGS_API_KEY"])
verify = openfilings_webhook_dependency(os.environ["OPENFILINGS_WEBHOOK_SECRET"])

@app.post("/openfilings-webhook")
async def on_filing(event: WebhookEvent = Depends(verify)) -> dict:
    if event.event == "filing.discovered":
        filing_id = event.data["filing_id"]
        kpis = client.filings.kpis(filing_id)
        ingest(event.data["ticker"], event.data["market_id"], kpis)  # your pipeline
    return {"ok": True}

bulk pull · cURL

# Filing history for one ticker / market
curl "https://api.openfilings.org/api/v1/tickers/AAPL/filings?market_id=us&limit=50" \
  -H "X-API-Key: $OPENFILINGS_API_KEY"

# Canonical KPIs for one filing
curl "https://api.openfilings.org/api/v1/filings/{filing_id}/kpis" \
  -H "X-API-Key: $OPENFILINGS_API_KEY"