कवरेज खंडित है
आपकी बुक US, EU, एशिया और GCC जारीकर्ताओं तक फैली है — प्रत्येक का अपना नियामक पोर्टल, फाइलिंग प्रारूप और खुलासा अंतराल। घर में जोड़ना प्रति बाज़ार स्क्रेपर और प्रति वर्गीकरण पार्सर है।
हेज फंड के लिए
58 नियामक स्रोत एक क्रॉस-GAAP KPI वर्गीकरण में सामान्यीकृत, हस्ताक्षरित वेबहुक जो वॉचलिस्ट पर फाइलिंग आते ही चलता है — स्क्रेपर नहीं, PDF पार्सर नहीं, रात का बैच नहीं।
pip install openfilings और दोपहर में पहला हैंडलर जोड़ें।
समस्या
आपकी बुक US, EU, एशिया और GCC जारीकर्ताओं तक फैली है — प्रत्येक का अपना नियामक पोर्टल, फाइलिंग प्रारूप और खुलासा अंतराल। घर में जोड़ना प्रति बाज़ार स्क्रेपर और प्रति वर्गीकरण पार्सर है।
10-K, Yūho, DART, MOPS और ESEF वार्षिक रिपोर्ट सभी «राजस्व» अलग कहती हैं। सामान्यीकरण के बिना क्रॉस-बाज़ार स्क्रीन और फैक्टर मॉडल उन संख्याओं पर चलते हैं जो वास्तव में तुलनीय नहीं।
एक बार खींचा और कैश किया KPI जारीकर्ता के संशोधन पर पुराना हो जाता है। बैकटेस्ट और लाइव पोजीशन के लिए बिंदु-समय सही होना ज़रूरी है।
आपको क्या मिलता है
फाइलिंग सीधे नियामक फ़ीड से खींची जाती हैं — SEC EDGAR, EDINET, OpenDART, MOPS, ESEF, Companies House, और 58 बाज़ारों में और — हर रिकॉर्ड पर मूल दस्तावेज़ का लिंक।
राजस्व, मार्जिन, EPS और YoY डेल्टा बाज़ारों और लेखा मानकों पर एक वर्गीकरण में सामान्यीकृत — हर खुलासा प्रारूप खुद पार्स करने के बजाय एक लाइन आइटम कोड क्वेरी करें।
एक बार URL रजिस्टर करें; वॉचलिस्ट पर नई फाइलिंग, प्रेस रिलीज़ और इनसाइडर लेनदेन HMAC-हस्ताक्षरित POST के रूप में आते हैं — पोलिंग लूप नहीं, केवल मानक लाइब्रेरी से सत्यापन योग्य।
पाइपलाइन
01
search_ticker / entities.search नाम, टिकर, LEI या ISIN को एक कैननिकल जारीकर्ता में हल करता है — एक बाज़ार मानने से पहले entity.listings[] पढ़ें।
02
get_company_financials एक कॉल में fiscal_year_from/to और line_items फ़िल्टर के साथ बहु-वर्ष श्रृंखला खींचता है — मानक KPI बैकफ़िल के लिए प्रति-फाइलिंग लूप नहीं।
03
एक बार वेबहुक बनाएँ (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 प्लान शर्तों के साथ फॉलो अप करेगा।
FAQ
OpenFilings प्राथमिक-स्रोत फाइलिंग और मानकीकृत-KPI परत है, मार्केट-डेटा टर्मिनल नहीं — कोई मूल्य नहीं, कोई आम सहमति अनुमान नहीं। यह नियामक-इवेंट और फंडामेंटल्स पक्ष के लिए आपके मौजूदा डेटा स्टैक के साथ बैठने के लिए बना है: क्या फाइल हुआ, कब, और सामान्यीकृत संख्याएँ क्या कहती हैं।
खोज-से-क्वेरी आमतौर पर RSS/स्ट्रीम-नेटिव बाज़ारों के लिए 60 सेकंड से कम है; वेबहुक स्थायित्व के तुरंत बाद चलता है, इसलिए आपका हैंडलर अधिकांश हेडलाइन एग्रीगेटर के सारांश से पहले इवेंट देखता है।
हस्ताक्षरित वेबहुक डिलीवरी Business-प्लान फीचर है (देखें /pricing)। REST API और Python SDK हर भुगतान प्लान पर काम करते हैं; वेबहुक पोलिंग के ऊपर पुश परत जोड़ते हैं।
कोई भी — pip install openfilings उसी REST API को टाइप किए मॉडल, स्वचालित 429 बैकऑफ, और stdlib-only verify_webhook() हेल्पर से लपेटता है। हर SDK प्रतिक्रिया .raw / .to_dict() भी देती है जिन फ़ील्ड को हमने अभी नहीं लपेटा।
हर फाइलिंग के खुलासा लाइन आइटम पार्स समय पर साझा वर्गीकरण (GET /api/v1/kpi-taxonomy / client.companies.kpi_taxonomy()) से मैप होते हैं, इसलिए US 10-K, Yūho और ESEF वार्षिक रिपोर्ट का राजस्व उसी line_items कोड से क्वेरी होता है।
KPI संशोधित फाइलिंग के विरुद्ध फिर से निकाले जाते हैं और API डिफ़ॉल्ट रूप से नवीनतम मान देता है; बिंदु-समय मान चाहिए तो get_company_financials as_of पैरामीटर स्वीकार करता है।