बिना की के मुफ्त स्टॉक मार्केट डेटा API का उपयोग कैसे करें

Strasmore API का अवलोकन

Strasmore एक मुफ्त स्टॉक मार्केट डेटा API संचालित करता है जिसके लिए किसी की या साइनअप की आवश्यकता नहीं है। यह US इक्विटी और ऑप्शंस डेटा पर क्यूरेटेड, केवल-पठनीय (read-only) क्वेरीज़ का एक बढ़ता हुआ सेट प्रदान करता है, जो HTTPS पर सादे JSON के रूप में उपलब्ध है। इसे जानबूझकर AI एजेंटों और लोगों, दोनों के लिए खुला रखा गया है। यह एक दुर्लभ सेवा का बिना किसी की (keyless) वाला डेमो भी है: एक free SQL API जहाँ एक मुफ्त खाता अपनी खुद की क्वेरी लिख सकता है। यह पृष्ठ प्रत्येक एंडपॉइंट का दस्तावेजीकरण करता है, कार्यशील कॉल दिखाता है, और उसी डेटा को चार्ट करता है जिसे API वापस भेजता है।

फ्री API क्या प्रदान करता है

प्रत्येक की (key) बाजार के पाठक द्वारा पूछे जाने वाले एक वास्तविक प्रश्न का उत्तर देती है। इस लेखन के समय उपलब्ध कैटलॉग इस प्रकार है:

• spy_qqq: पिछले पैंतालीस सत्रों में SPY और QQQ का सामान्यीकृत रिटर्न
• dividend_yield_leaders: नवीनतम सत्र में उच्चतम लार्ज-कैप डिविडेंड यील्ड
• upcoming_ex_dividends: आगामी अमेरिकी ex-dividend तारीखें, नकद राशि और भुगतान तिथियों के साथ
• short_interest_watch: नवीनतम शॉर्ट-इंटरेस्ट सेटलमेंट के अनुसार days-to-cover में अग्रणी शेयर
• iv_leaders: लिक्विड ऑप्शन अंडरलाइंग्स के बीच दिन के अंत में implied-volatility में अग्रणी
• recent_ipos: पिछले एक सौ अस्सी दिनों की अमेरिकी लिस्टिंग, ऑफर मूल्य और आकार के साथ
• latest_market_news: नवीनतम बाजार सुर्खियां और उनमें उल्लिखित टिकर
• biggest_movers: लिक्विड नामों के बीच नवीनतम नियमित सत्र में सबसे बड़ी हलचल
• revenue_leaders: नवीनतम वार्षिक राजस्व और शुद्ध आय के आधार पर सबसे बड़ी अमेरिकी कंपनियां
• most_active_options: जहां ऑप्शन वॉल्यूम केंद्रित है, औसत implied volatility के साथ
• put_call_ratio: सबसे सक्रिय अंडरलाइंग्स का put/call वॉल्यूम अनुपात
• upcoming_splits: हालिया और निर्धारित स्टॉक स्प्लिट
• market_holidays: NYSE की आगामी छुट्टियां और जल्दी बंद होने के समय

इक्विटी कीमतें विलंबित हैं। ऑप्शन ग्रीक्स और implied volatility दिन के अंत के मान हैं। प्रत्येक पेलोड में वह सटीक SQL शामिल है जिसने इसे तैयार किया है, ताकि किसी भी संख्या को उसकी क्वेरी तक ट्रैक किया जा सके।

इसे कैसे कॉल करें

एक GET अनुरोध, किसी हेडर की आवश्यकता नहीं है:

curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

कैटलॉग एंडपॉइंट प्रत्येक उपलब्ध की (key) को एक रेडी-टू-फेच URL, प्रत्येक क्वेरी का सरल अंग्रेजी विवरण और उपयोग संबंधी नोट्स के साथ सूचीबद्ध करता है। यदि आप प्रोग्राम के माध्यम से API को खोज रहे हैं, तो पहले इसे फेच करें:

curl "https://ai.strasmore.com/api/demo/catalog"

एक रिस्पॉन्स में रिज़ॉल्व की गई की (key), उसके द्वारा उत्तर दिया गया प्रश्न, SQL, कॉलम के नाम, पंक्तियाँ और दो पॉइंटर फ़ील्ड होते हैं। इसका स्वरूप (मान हटा दिए गए हैं):

{
  "key": "dividend_yield_leaders",
  "label": "Highest dividend yields, large caps, latest session",
  "nl": "Which large-cap US stocks currently have the highest dividend yields?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Get more at https://www.strasmore.com ..."
}

ऐसी की (key) पास करना जो मौजूद नहीं है, डिफ़ॉल्ट क्वेरी को सर्व करता है और विफल होने के बजाय इसे fallback_from फ़ील्ड के साथ फ्लैग करता है। उस फ़ील्ड को स्पेलिंग अलार्म के रूप में मानें, और वैध कीज़ (keys) के लिए कैटलॉग को ही सत्य का स्रोत मानें।

एजेंटों और LLM के लिए निर्मित

यह डेमो इस तरह डिज़ाइन किया गया है कि इसे ऐसे सॉफ़्टवेयर द्वारा कॉल किया जा सके जिसे आपको आज लिखने की आवश्यकता नहीं थी। रिस्पॉन्स access-control-allow-origin: * सेट करते हैं और CORS प्रीफ़्लाइट किसी भी ओरिजिन से अनुमति देते हैं, ताकि ब्राउज़र ऐप्स, नोटबुक और LLM एजेंट सीधे डेटा प्राप्त कर सकें। इसके पीछे, प्रत्येक क्वेरी अधिकतम हर दस मिनट में पुनर्गणना (recompute) करती है और कुछ मिलीसेकंड में मेमोरी से रिस्पॉन्स देती है।

मशीन-रीडेबल एंट्री पॉइंट्स, उस क्रम में जिसमें एक एजेंट को उन्हें पढ़ना चाहिए:

1. https://www.strasmore.com/llms.txt एक संक्षिप्त फ़ाइल में कंटेंट इंडेक्स और डेमो API का नाम बताता है।
2. https://ai.strasmore.com/api/demo/catalog URL के साथ प्रत्येक क्वेरी को सूचीबद्ध करता है।
3. प्रत्येक रिस्पॉन्स का more फ़ील्ड कैटलॉग और पूर्ण उत्पाद की ओर इशारा करता है।

शिष्टाचार संबंधी दो बातें। प्रत्येक क्वेरी के आंकड़े अधिकतम हर दस मिनट में रिफ्रेश होते हैं, इसलिए उससे तेज़ पोलिंग करने पर समान डेटा ही प्राप्त होगा। प्रत्येक पेलोड के भीतर source फ़ील्ड यह बताता है कि डेटा कहाँ से आया है; जब आप किसी आंकड़े को पुनः प्रकाशित करें, तो व्यावहारिक होने पर इसे दृश्यमान रखें।

डेमो के पीछे का डेटा

API के उत्तर उसी डेटा वेयरहाउस से आते हैं जिसे यह ब्लॉग पढ़ता है। नीचे दिए गए पैनल ब्लॉग पाइपलाइन के माध्यम से डेमो की क्वेरी चलाते हैं, और प्रत्येक के नीचे SQL खुला हुआ है।

spy_qqq की SPY और QQQ के क्लोजिंग भावों को पैंतालीस-दिवसीय विंडो की शुरुआत से प्रतिशत रिटर्न में सामान्यीकृत (normalize) करती है। वर्तमान विंडो में 32 सत्रों के दौरान, SPY की संचयी चाल -0.54% मापी गई है और QQQ की चाल -0.25% मापी गई है।

SELECT day,
       round((spy / first_value(spy) OVER (ORDER BY day ASC) - 1) * 100, 2) AS spy_return_pct,
       round((qqq / first_value(qqq) OVER (ORDER BY day ASC) - 1) * 100, 2) AS qqq_return_pct
FROM (
    SELECT toDate(window_start) AS day,
           argMaxIf(close, window_start, ticker = 'SPY') AS spy,
           argMaxIf(close, window_start, ticker = 'QQQ') AS qqq
    FROM global_markets.delayed_stocks_minute_aggs
    WHERE ticker IN ('SPY', 'QQQ') AND window_start >= now() - INTERVAL 45 DAY
    GROUP BY day
)
ORDER BY day

dividend_yield_leaders की दो प्रतिशत से पंद्रह प्रतिशत के बीच यील्ड और दो बिलियन डॉलर से अधिक के मार्केट कैप वाली कंपनियों को स्क्रीन करती है। निचली सीमा शोर को हटाती है और ऊपरी सीमा उन विशेष-लाभांश (special-dividend) आर्टिफैक्ट्स को हटाती है जो ऐसी यील्ड दर्शाते हैं जिसे कोई कंपनी बनाए नहीं रख सकती। Oct 15 तक, इस स्क्रीन में शीर्ष पर STWD है, जिसकी यील्ड 14.99% है। दशकों में किसी एक कंपनी के भुगतान इतिहास को समझने के लिए, Microsoft का लाभांश इतिहास देखें।

SELECT ticker,
       round(dividend_yield * 100, 2) AS dividend_yield_pct,
       formatDateTime(date, '%b %e') AS as_of_label
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND dividend_yield BETWEEN 0.02 AND 0.15
  AND market_cap > 2e9
  AND ticker NOT IN ('SPCX')
ORDER BY dividend_yield DESC
LIMIT 12

iv_leaders की सभी सूचीबद्ध स्ट्राइक और एक्सपायरी पर अंतर्निहित परिसंपत्ति (underlying) के लिए दिन के अंत की इंप्लाइड वोलैटिलिटी का औसत निकालती है, सार्थक ऑप्शन वॉल्यूम वाले नामों को रखती है, और उन्हें रैंक करती है। वर्तमान में PDSB शीर्ष पर है, जिसकी औसत इंप्लाइड वोलैटिलिटी 240.9% है। इस स्क्रीन पर उच्च रीडिंग उन नामों को चिह्नित करती है जहाँ ऑप्शन मार्केट बड़ी चालों की कीमत तय करता है; स्क्रीन केवल स्तर बताती है और व्याख्या आप पर छोड़ती है।

SELECT underlying_symbol AS ticker,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND underlying_symbol NOT IN ('SPCX')
GROUP BY underlying_symbol
HAVING sum(volume) > 10000
ORDER BY avg_iv_pct DESC
LIMIT 12

short_interest_watch की हमारे शॉर्ट-इंटरेस्ट डेटा गाइड में बताए गए उसी FINRA डेटासेट से डेज़-टू-कवर को रैंक करती है, और upcoming_ex_dividends कॉर्पोरेट-एक्शन कैलेंडर को पढ़ती है। दोनों ऊपर दिए गए पैटर्न का पालन करती हैं: एक निश्चित स्क्रीन, एक सीमित परिणाम, और पेलोड में SQL।

डेमो से पूर्ण वेयरहाउस तक

डेमो की क्वेरी जानबूझकर निश्चित रखी गई हैं: ये सस्ती, कैश करने योग्य और सभी के लिए सुरक्षित रहती हैं। इनके पीछे मौजूद वेयरहाउस में अमेरिकी इक्विटी का बाईस वर्षों का और ऑप्शंस का बारह वर्षों का इतिहास उपलब्ध है। एक मुफ्त खाता (बिना कार्ड के) इसके विरुद्ध अपनी SQL क्वेरी लिख सकता है, जिसकी सीमा प्रतिदिन एक सौ क्वेरी है। भुगतान वाले टियर पूर्ण इतिहास, टिक डेटा और प्रोग्रामेटिक API कीज़ तक पहुंच प्रदान करते हैं। जब एक निश्चित स्क्रीन पर्याप्त न रहे, तो फ्री SQL टियर अगला कदम है।

अक्सर पूछे जाने वाले प्रश्न

क्या Strasmore मार्केट डेटा API वास्तव में मुफ्त है?

हाँ। डेमो एंडपॉइंट्स के लिए किसी की (key), साइनअप या भुगतान विवरण की आवश्यकता नहीं होती है। वे केवल निश्चित क्वेरी प्रदान करते हैं; मनमाने प्रश्न पूर्ण उत्पाद पर चलते हैं।

क्या मुझे API की (key) या प्रमाणीकरण की आवश्यकता है?

नहीं। प्रत्येक डेमो एंडपॉइंट सामान्य अनधिकृत GET अनुरोधों का उत्तर देता है। कीज़ केवल सशुल्क प्रोग्रामेटिक API के लिए मौजूद हैं, जो कस्टम क्वेरी चलाती हैं।

डेमो डेटा कितना ताज़ा है?

इक्विटी कीमतें रीयल-टाइम के बजाय विलंबित (delayed) होती हैं। अनुपात, शॉर्ट इंटरेस्ट और कॉर्पोरेट क्रियाएं अपने स्रोत की गति पर अपडेट होती हैं। ग्रीक्स और इंप्लाइड वोलेटिलिटी दिन के अंत (end-of-day) के होते हैं। प्रत्येक क्वेरी का परिणाम अधिकतम हर दस मिनट में रिफ्रेश होता है।

क्या मेरा LLM एजेंट या ब्राउज़र ऐप इसे सीधे कॉल कर सकता है?

हाँ। प्रतिक्रियाएं किसी भी ओरिजिन से ओपन CORS के साथ उत्तर देती हैं, प्रीफ्लाइट्स हर जगह सफल होते हैं, और /api/demo/catalog पर मौजूद कैटलॉग प्रत्येक क्वेरी का वर्णन JSON में करता है जिसे एक एजेंट बिना किसी दस्तावेज़ के पढ़ सकता है।

यदि मैं ऐसी की (key) का अनुरोध करूं जो मौजूद नहीं है, तो क्या होगा?

API डिफ़ॉल्ट spy_qqq क्वेरी प्रदान करता है और एक fallback_from फ़ील्ड जोड़ता है जो आपके द्वारा पूछे गए प्रश्न का नाम बताता है। मान्य कीज़ की सूची के लिए कैटलॉग देखें।

इस पृष्ठ पर प्रत्येक पैनल एक लाइव स्टोर्ड क्वेरी है, और वही वेयरहाउस उन प्रश्नों का उत्तर देता है जिन्हें आप स्वयं SQL या सामान्य अंग्रेजी में Strasmore टर्मिनल पर लिखते हैं।