कार्यप्रणाली

StockVS एक स्वचालित पाइपलाइन से तैयार होता है: डेटा संग्रहण, रात्रि निर्माण, स्वचालित जांचें और प्रकाशन, जिनमें से हर एक का वर्णन नीचे किया गया है।

बाज़ार डेटा ओपन-सोर्स yfinance लाइब्रेरी के माध्यम से Yahoo Finance से आता है: दैनिक कीमतें और वॉल्यूम, लाभांश, प्रमुख आंकड़ों के साथ कंपनी और फंड प्रोफाइल, स्टॉक के लिए वार्षिक आय विवरण और ETFs के लिए प्रमुख होल्डिंग्स। शामिल प्रतिभूतियां अमेरिकी और कनाडाई एक्सचेंजों की सार्वजनिक सूचियों से ली गई हैं; समाचार शीर्षक Finnhub समाचार सेवा से आते हैं। डिपॉजिटरी रसीदों (ADR) के लिए, बाजार पूंजीकरण ADR मूल्य को ADR-समतुल्य शेयर संख्या से गुणा करके प्राप्त होता है, जैसा Yahoo Finance इसे रिपोर्ट करता है; जब ADR प्रीमियम पर कारोबार करता है तो यह कंपनी के घरेलू बाजार मूल्य से भिन्न हो सकता है (उदाहरण के लिए TSM और SKHY)।

संग्रहण जॉब्स हर प्रतिभूति की कीमतें और प्रोफाइल, और स्टॉक के लिए समाचार शीर्षक, एक PostgreSQL डेटाबेस में लिखते हैं। हर रात एक स्थिर-साइट निर्माण उस डेटाबेस से हर पेज तैयार करता है, और स्वचालित जांचें परिणाम का निरीक्षण करती हैं; यदि कोई जांच विफल होती है, तो कुछ भी अपलोड नहीं किया जाता और पिछला संस्करण ऑनलाइन बना रहता है। जो निर्माण सफल होता है उसे Cloudflare के नेटवर्क के पीछे स्थिर होस्टिंग पर अपलोड किया जाता है, और फिर यह पुष्टि करने के लिए कि वे प्रतिक्रिया देते हैं, नए पेजों का एक यादृच्छिक नमूना लोड किया जाता है।

कीमतें हर कारोबारी दिन बाज़ार बंद होने के बाद एकत्र की जाती हैं, और संग्रहण पूरा होने पर रात्रि निर्माण शुरू होता है, इसलिए पेज सामान्यतः उसी शाम उस दिन की क्लोजिंग कीमतें दिखाते हैं; सप्ताहांत के निर्माण पिछले सत्र के डेटा का उपयोग करते हैं। कंपनी प्रोफाइल और प्रमुख आंकड़े हर कार्यदिवस ताज़ा किए जाते हैं, ETF होल्डिंग्स और ETF का पूरा कीमत इतिहास साप्ताहिक रूप से, और हर कंपनी के आय विवरण लगभग हर तिमाही, किसी नई सूचीबद्ध कंपनी के एक सप्ताह के भीतर। स्टॉक के लिए समाचार शीर्षक सबसे बड़ी कंपनियों के लिए रोज़ाना और छोटी कंपनियों के लिए कुछ दिनों के अंतराल पर ताज़ा किए जाते हैं। यदि किसी कार्यदिवस का संग्रहण विफल होता है, तो उस शाम का निर्माण नहीं चलता, पिछला संस्करण ऑनलाइन बना रहता है और एक मॉनिटर अलर्ट भेजता है।

ट्रेलिंग अवधियों, कैलेंडर वर्षों और महीनों के लिए रिटर्न संग्रहीत दैनिक क्लोजिंग कीमतों से निकाले जाते हैं, जिन्हें Yahoo Finance ने डाउनलोड के समय स्टॉक स्प्लिट और लाभांश के लिए समायोजित किया था; अस्थिरता दैनिक रिटर्न का वार्षिकीकृत मानक विचलन है। बाज़ार पूंजीकरण, वैल्यूएशन अनुपात, मार्जिन, प्रति शेयर आय और लाभांश प्रतिफल जैसा Yahoo Finance उन्हें रिपोर्ट करता है वैसे ही दिखाए जाते हैं, और किसी प्रशंसनीय दायरे से बाहर का मूल्य नहीं दिखाया जाता। आंकड़े अपनी रिपोर्टिंग मुद्रा, अमेरिकी या कनाडाई डॉलर, बनाए रखते हैं और कभी परिवर्तित नहीं किए जाते; दोनों मुद्राओं में फैले योग प्रत्येक मुद्रा में अलग-अलग दिए जाते हैं। उद्योग तुलनाएं उद्योग की माध्यिका का उपयोग करती हैं, और प्रतिशतों के बीच के अंतर को प्रतिशत बिंदुओं में बताया जाता है।

स्टॉक और ETF पेजों पर विश्लेषण हर समर्थित भाषा में पहले से लिखे गए वाक्य टेम्पलेट्स से जोड़ा जाता है, जिन्हें डेटाबेस के आंकड़ों से भरा जाता है। कोई डेटा गायब होने पर संबंधित वाक्य छोड़ दिया जाता है, कोई खाली स्थान नहीं छोड़ा जाता। टेम्पलेट्स डेटा और उद्योग की माध्यिकाओं से उसकी तुलना का वर्णन करते हैं, बिना किसी रेटिंग, सिफ़ारिश या भविष्यवाणी के। साइट बनाते समय कोई भाषा मॉडल नहीं चलता, और कोई मॉडल किसी एक स्टॉक या फंड के बारे में टेक्स्ट नहीं लिखता। कुछ समाचार शीर्षकों के साथ लगे अमूर्त चित्र एक बार एक छवि मॉडल द्वारा बनाए गए थे और वे घटनाओं को नहीं दर्शाते।

संग्रहण के दौरान, कोई कीमत केवल उन दिनों के लिए संग्रहीत की जाती है जब संबंधित प्रतिभूति का अपना बाज़ार खुला था, उस दिन की कीमत केवल सत्र बंद होने के बाद, और दैनिक अपडेट किसी संग्रहीत क्लोजिंग कीमत को लाइव कोटेशन से बदल नहीं सकता। डेटा फ़ीड से मिला कोई कटा हुआ नाम किसी संग्रहीत पूरे नाम की जगह नहीं ले सकता, और जो प्रतिभूतियां कीमतें भेजना बंद कर देती हैं उन्हें रन रिपोर्ट में चिह्नित किया जाता है। पेजों पर, जो कीमत अब मौजूदा नहीं है वह अपने अंतिम कारोबार की तारीख दिखाती है, और दोहरी-सूचीबद्ध कंपनियां केवल एक बार गिनी जाती हैं।

हर रात के प्रकाशन से पहले, स्वचालित जांचें तैयार साइट को पेज-दर-पेज या नमूने के आधार पर पढ़ती हैं। निर्माण का आकार पिछले प्रकाशित संस्करण के करीब होना चाहिए, इसमें कम से कम उतने ही पेज होने चाहिए जितने इसके साइटमैप सूचीबद्ध करते हैं, और इसमें कीमतें कार्यक्रम की अपेक्षा जितनी हाल की होनी चाहिए। संरचित डेटा सुव्यवस्थित होना चाहिए, कीमत की तारीखें कारोबारी दिनों पर ही और कभी भविष्य में नहीं होनी चाहिए, हर पेज पर डेटा की एक ही तारीख होनी चाहिए, और गणनाएं व योग सभी पेजों पर मेल खाने चाहिए। कोई तालिका किसी कंपनी को दो बार सूचीबद्ध नहीं कर सकती या अलग-अलग मुद्राओं को जोड़ नहीं सकती। विश्लेषण और सूची सारांशों को पेज की भाषा की लिपि का उपयोग करना चाहिए।

StockVS रीयल-टाइम कोटेशन प्रदान नहीं करता: डेटा दिन के अंत का होता है, और कुछ पेज एक सत्र या उससे अधिक पीछे रह सकते हैं जब Yahoo Finance कोई क्लोजिंग कीमत देर से प्रकाशित करता है या कोई संग्रहण विफल हो जाता है। आंकड़े केवल उतने ही सटीक हैं जितना Yahoo Finance का डेटा है। सभी वित्तीय मेट्रिक्स हर स्टॉक या ETF के लिए उपलब्ध नहीं हैं। ऐतिहासिक डेटा की उपलब्धता टिकर के अनुसार भिन्न होती है। अधिकांश कीमत इतिहास दिन-प्रतिदिन बढ़ाए जाते हैं, इसलिए कोई बाद का स्टॉक स्प्लिट या लाभांश समायोजन पुरानी कीमतों तक शायद न पहुंचे, और लंबी अवधि के रिटर्न अन्य स्रोतों से भिन्न हो सकते हैं। जो प्रतिभूतियां कारोबार करना बंद कर देती हैं वे अपना पेज बनाए रखती हैं, जिसमें अंतिम कीमत को अब मौजूदा नहीं के रूप में चिह्नित किया जाता है, और कंपनी विवरण केवल अंग्रेज़ी स्टॉक पेजों पर ही दिखाई देते हैं।

त्रुटियां ऊपर बताई गई स्वचालित जांचों से और प्रकाशित पेजों की समीक्षा से मिलती हैं। हर त्रुटि को उसके स्रोत पर ठीक किया जाता है — डेटा में, किसी गणना में या किसी टेम्पलेट में — और अगला रात्रि पुनर्निर्माण उस सुधार को हर प्रभावित पेज तक पहुँचाता है; सुधार परियोजना के आंतरिक इश्यू ट्रैकर में दर्ज किए जाते हैं। वर्तमान में त्रुटियां रिपोर्ट करने के लिए कोई सार्वजनिक माध्यम नहीं है।