इस प्रोजेक्ट के बारे में

Vnstock वियतनाम वित्तीय-बाज़ार अनुसंधान के लिए एक Python पारिस्थितिकी तंत्र है। यह क्लाइंट-साइड कनेक्टर के रूप में काम करता है: अनुरोध उपयोगकर्ता के अपने वातावरण से तृतीय-पक्ष सार्वजनिक या खाता-आधारित स्रोतों को भेजे जाते हैं, और परिणामों को विश्लेषण, भंडारण या डेटा पाइपलाइनों के लिए DataFrames में सामान्यीकृत किया जाता है। परियोजना बताती है कि यह पुनर्विक्रय के लिए मार्केट-डेटा वेयरहाउस संचालित नहीं करती, अपस्ट्रीम डेटा को लाइसेंस नहीं देती, या निवेश सलाह प्रदान नहीं करती। संस्करण 4 का एकीकृत इंटरफ़ेस कार्यक्षमता को Market, Reference, Fundamental और Retail डोमेन में व्यवस्थित करता है। प्रमाणित क्षमताओं में स्टॉक, सूचकांक, ETF, वारंट, फ्यूचर्स, फोरेक्स, कमोडिटी और क्रिप्टो के लिए ऐतिहासिक OHLCV डेटा; विलंबित इन-सेशन कोट्स और टिक-बाय-टिक ट्रेड; कंपनी प्रोफ़ाइल, नेतृत्व, शेयरधारक, सहायक कंपनियाँ, स्वामित्व, इनसाइडर ट्रेडिंग, पूंजी इतिहास, समाचार और घटनाएँ; सिंबल, उद्योग और एक्सचेंज लिस्टिंग; बैलेंस शीट, आय विवरण, कैश-फ्लो स्टेटमेंट और वित्तीय अनुपात; म्यूचुअल-फंड होल्डिंग्स और NAV डेटा; साथ ही रिटेल सोने की कीमतें और विनिमय दरें शामिल हैं। डेटा कवरेज चयनित स्रोत पर निर्भर करता है और बदल सकता है। पैकेज Vnstock के पैकेज इंडेक्स से इंस्टॉल किया जाता है, जबकि अन्य निर्भरताएँ PyPI से आती हैं। अतिथि पहुँच बिना पंजीकरण के प्रति मिनट 20 कॉल तक सीमित है, मुफ़्त पंजीकृत खाते प्रति मिनट 60 कॉल तक, और प्रायोजक स्तर प्रति मिनट 180–600 कॉल तक। API कुंजियाँ इंटरैक्टिव पंजीकरण फ़ंक्शन या VNSTOCK_API_KEY पर्यावरण चर के माध्यम से प्रदान की जा सकती हैं। दस्तावेज़ीकरण प्रत्येक अपस्ट्रीम स्रोत की शर्तों के अनुपालन और विश्लेषण, ट्रेडिंग या प्रकाशन से पहले आधिकारिक स्रोतों के विरुद्ध सत्यापन पर जोर देता है। AI-सहायक एकीकरण वैकल्पिक है और वर्तमान संस्करणों में डिफ़ॉल्ट रूप से अक्षम है। उपयोगकर्ता Claude Code, Codex और Antigravity जैसे टूल के लिए प्रोजेक्ट-स्तरीय या सहायक-विशिष्ट संदर्भ फ़ाइलें स्पष्ट रूप से उत्पन्न कर सकते हैं; पर्यावरण चर इस व्यवहार को कॉन्फ़िगर या अक्षम कर सकते हैं। परियोजना शुरुआती लोगों के लिए Google Colab और AI-सहायित कोडिंग गाइड भी प्रदान करती है। इसका स्रोत एक कस्टम लाइसेंस के तहत प्रकाशित है जो व्यक्तिगत, शैक्षिक और अनुसंधान उपयोग की बिना शुल्क अनुमति देता है, लेकिन यह OSI-अनुमोदित ओपन-सोर्स लाइसेंस नहीं है; पुनर्वितरण और ऐसा उत्पाद बनाना जिसका मुख्य मूल्य तृतीय-पक्ष डेटा पहुँच है, के लिए अलग लिखित अनुमति आवश्यक है।