הכיסוי מפוצל
התיק שלכם חוצה מנפיקים בארה״ב, באירופה, באסיה ובמפרץ — לכל אחד פורטל רגולטור, פורמט דיווח ופיגור גילוי משלו. תפירה בבית פירושה סקרייפר לכל שוק ומנתח לכל טקסונומיה.
לקרנות גידור
58 מקורות רגולטור מנורמלים לטקסונומיית KPI אחת חוצת-GAAP, עם webhook חתום שנורה ברגע שדיווח נוחת ברשימת המעקב — בלי סקרייפר, בלי מנתח PDF, בלי אצווה לילית לתחזק.
pip install openfilings וחברו את הטיפול הראשון תוך אחר הצהריים.
הבעיה
התיק שלכם חוצה מנפיקים בארה״ב, באירופה, באסיה ובמפרץ — לכל אחד פורטל רגולטור, פורמט דיווח ופיגור גילוי משלו. תפירה בבית פירושה סקרייפר לכל שוק ומנתח לכל טקסונומיה.
10-K, Yūho, DART, MOPS ודוחות שנתיים של ESEF כולם אומרים ״הכנסות״ אחרת. בלי נרמול, מסכים חוצי-שווקים ומודלי פקטור רצים על מספרים שאינם באמת ברי-השוואה.
KPI שנשלף פעם אחת ונשמר במטמון מתיישן ברגע שמנפיק מתקן דיווח. נכונות בנקודת-זמן חשובה לבדיקות לאחור ולכל דבר שנוגע לפוזיציה חיה.
מה מקבלים
דיווחים נשלפים ישירות מפיד הרגולטור — SEC EDGAR, EDINET, OpenDART, MOPS, ESEF, Companies House ועוד ב-58 שווקים — עם קישור חזרה למסמך המקור בכל רשומה.
הכנסות, מרווחים, EPS ודלתאות YoY מנורמלים לטקסונומיה אחת בין שווקים ותקני חשבונאות — שאלו קוד פריט שורה אחד במקום לנתח כל פורמט גילוי בעצמכם.
רשמו כתובת פעם אחת; דיווחים חדשים, הודעות לעיתונות ועסקאות פנים ברשימת המעקב נוחתים כ-POST חתום ב-HMAC — בלי לולאת סקר, ניתן לאימות עם הספרייה הסטנדרטית בלבד.
צינור
01
search_ticker / entities.search מזהים שם, טיקר, LEI או ISIN למנפיק קנוני אחד — קראו את entity.listings[] לפני שמניחים שוק יחיד.
02
get_company_financials שולף סדרת תקופות רב-שנתית עם מסנני fiscal_year_from/to ו-line_items בקריאה אחת — בלי לולאה לכל דיווח להשלמת KPI רגילה.
03
צרו webhook פעם אחת (event_types=["filing.discovered"]); כל גילוי חדש ברשימת המעקב מגיע חתום, תוך שניות, במקום סקר לילי.
04
verify_webhook() בודק את החתימה עם hmac.compare_digest, ואז GET /api/v1/filings/{id}/kpis / get_filing_section ממלאים מה שהאות שלכם צריך מאותו filing_id.
אינטגרציה
משלוחים נחתמים ב-HMAC-SHA256 על גוף הבקשה הגולמי — verify_webhook() לא צריך דבר מעבר לספרייה הסטנדרטית של Python.
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":
kpis = client.filings.kpis(event.data["filing_id"])
# ... run your signal against kpis.canonical ...
print(event.data["ticker"], kpis.canonical.get("revenue"))
return {"ok": True}filing.discovered payload
{
"event": "filing.discovered",
"version": "1",
"timestamp": "2026-08-08T09:14:02.331Z",
"data": {
"canonical_key": "sec:0000320193",
"ticker": "AAPL",
"market_id": "us",
"form_type": "10-Q",
"filing_id": "3f1b7e2a-...",
"filing_date": "2026-08-08"
}
}כיסוי חי
קבלת גישה
הדביקו את הטיקרים או ה-ISIN שאתם מכסים ומה שאתם בונים — מוביל הנדסת נתונים יחזור עם גישת API, פירוט כיסוי לשווקים שלכם, ותנאי תוכנית Business למשלוח webhook.
שאלות נפוצות
OpenFilings הוא שכבת דיווחי מקור ראשוני ו-KPI מתוקננים, לא טרמינל נתוני שוק — בלי תמחור, בלי אומדני קונצנזוס. הוא בנוי לשבת ליד ערימת הנתונים הקיימת שלכם בצד אירוע רגולטורי ויסודות: מה הוגש, מתי, ומה אומרים המספרים המנורמלים.
מגילוי לשאילתה בדרך כלל פחות מ-60 שניות בשווקים מבוססי RSS/זרם; ה-webhook נורה מיד אחרי שמירה, כך שהמטפל שלכם רואה את האירוע לפני שרוב אגרגטורי הכותרות מפרסמים תקציר.
משלוח webhook חתום הוא יכולת של תוכנית Business (ראו /pricing). REST API ו-SDK ב-Python עובדים בכל תוכנית בתשלום; webhooks מוסיפים את שכבת הדחיפה מעל הסקר.
שניהם — pip install openfilings עוטף את אותו REST API במודלים מוקלדים, backoff אוטומטי ל-429, ועוזר verify_webhook() שמסתמך רק על הספרייה הסטנדרטית. כל תגובת SDK חושפת גם .raw / .to_dict() לשדות שעדיין לא עטפנו.
פריטי השורה שגילה כל דיווח ממופים לטקסונומיה משותפת (GET /api/v1/kpi-taxonomy / client.companies.kpi_taxonomy()) בזמן הניתוח, כך שהכנסות מ-10-K אמריקאי, מ-Yūho ומדוח שנתי של ESEF ניתנות לשאילתה כאותו קוד line_items.
KPI מחושבים מחדש מול הדיווח המתוקן וה-API מגיש כברירת מחדל את הערכים העדכניים; get_company_financials מקבל פרמטר as_of כשצריך את הערך בנקודת-זמן במקום.