यदि आपका मुख्य उद्देश्य यह जानना है कि earnings अनुमान से बेहतर हैं या खराब, तो AInvest का earnings calendar API काफी सीधा समाधान देता है।
इसके response में सामान्यतः ये फ़ील्ड मिलती हैं:
eps_actualeps_forecasteps_surpriserevenue_actualrevenue_forecastइनसे आप सीधे तुलना कर सकते हैं:
eps_actual > eps_forecast → Beat (उम्मीद से बेहतर)eps_actual < eps_forecast → Miss (उम्मीद से खराब)eps_actual = eps_forecast → Inlineयह लॉजिक ऑटोमेट करके आप अपने सिग्नल सिस्टम में तुरंत स्टेटस दिखा सकते हैं।
Bigdata का API खास तौर पर earnings surprise डेटा देने के लिए बनाया गया है। इसमें आम तौर पर ये जानकारी मिलती है:
reporting_dateeps_actualeps_estimatedrevenue_actualrevenue_estimatedइससे आप हाल ही में जारी हुए earnings को स्कैन करके देख सकते हैं कि कंपनियों ने अनुमान को beat किया या miss।
कुछ और सेवाएँ भी earnings calendar डेटा उपलब्ध कराती हैं:
इनमें से कई API REST या JSON फ़ॉर्मेट में डेटा देते हैं, जिससे इन्हें ट्रेडिंग सिस्टम या डैशबोर्ड में जोड़ना आसान होता है।
आप अपने सिस्टम में एक कॉलम इस तरह डिज़ाइन कर सकते हैं:
ticker | signal_time | earnings_status | earnings_date | earnings_session | eps_actual | eps_estimate | result
जहाँ:
earnings_status → upcoming / reportedearnings_session → pre‑market / after‑marketresult → beat / miss / inline / pendingलॉजिक उदाहरण:
if eps_actual is None:
result = "pending"
elif eps_actual > eps_estimate:
result = "beat"
elif eps_actual < eps_estimate:
result = "miss"
else:
result = "inline"
कुछ earnings APIs रिपोर्टिंग समय को before market open या after market close के रूप में देते हैं। लेकिन सभी इंटरफेस में यह फ़ील्ड मौजूद हो यह निश्चित नहीं है। इसलिए production में इस्तेमाल से पहले API response को टेस्ट करना जरूरी है।
यदि आप अपने ट्रेडिंग या सिग्नल सिस्टम में earnings जानकारी जोड़ना चाहते हैं, तो एक व्यावहारिक संयोजन यह हो सकता है:
इस तरह आप upcoming earnings समय, और प्रकाशित होने के बाद beat/miss स्थिति दोनों को अपने सिस्टम में ऑटोमेटिक तरीके से जोड़ सकते हैं।