फ़ाइनेंस · Yahoo Finance
ऐतिहासिक डेटा के लिए Yahoo Finance API
ऐतिहासिक डेटा के लिए Yahoo Finance API से आपको लाइव Yahoo Finance डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
Yahoo Finance चुपचाप वह सब रखता है जो किसी रिसर्च टूल को चाहिए: पहले ट्रेडिंग दिन तक का adjusted प्राइस इतिहास, trailing और forward मल्टीपल वाला statistics टैब, कंपनी प्रोफ़ाइल और तिमाही वित्तीय विवरण। everydata.io का Yahoo Finance API इन व्यू को, पूरे प्राइस इतिहास सहित, /yho के तहत HTTPS endpoint के रूप में देता है, जो वही JSON लौटाते हैं जो Yahoo ख़ुद रेंडर करता है – {raw, fmt} वैल्यू जोड़ों वाले बिना बदले quoteSummary.result[] ऑब्जेक्ट – ताकि Yahoo के डेटा मॉडल के बारे में आपकी जानकारी पूरी तरह काम आए। Yahoo ने 2017 से कोई आधिकारिक सार्वजनिक Finance API नहीं दिया है; यह वही आँकड़े पाने का एक मेंटेन किया हुआ, होस्टेड तरीका है – API key के साथ, किसी ऐसे स्क्रैपर के बजाय जिसकी आपको देखभाल करनी पड़े।
- प्लेटफ़ॉर्म
- Yahoo Finance
- मुख्य endpoint
- /stock-v3-get-historical-data
- हर कॉल पर quota
- 1 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
ऐतिहासिक डेटा के लिए Yahoo Finance API क्या लौटाता है
historical-data endpoint आपको {date, open, high, low, close, volume, adjclose} का एक फ़्लैट prices[] array देता है, जहाँ date सेकंड में Unix टाइमस्टैम्प है। 1d से max तक की range चुनें (1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max) और 1m से 3mo तक का interval (1m, 2m, 5m, 15m, 30m, 60m, 1d, 1wk, 1mo), या किसी खास अवधि का backfill करते समय range की जगह स्पष्ट period1/period2 epoch सीमाएँ दें। इंट्राडे interval सिर्फ़ हाल का समय कवर करते हैं, ठीक Yahoo के चार्ट की तरह।
प्राइस सीरीज़ के आसपास विवरण वाले endpoint हैं। /stock-v4-get-statistics, summaryDetail (marketCap, trailingPE, forwardPE, dividendYield, beta) और defaultKeyStatistics (enterpriseValue, profitMargins, floatShares, sharesShort, heldPercentInstitutions) लौटाता है। /stock-v3-get-profile सेक्टर, इंडस्ट्री, वेबसाइट और fullTimeEmployees देता है। /stock-get-fundamentals कॉमा से अलग modules पैरामीटर लेता है – balanceSheetHistory, cashflowStatementHistoryQuarterly, incomeStatementHistory, earningsTrend और लगभग 30 और – और सिर्फ़ वही मॉड्यूल लौटाता है।
- date (epoch सेकंड), open, high, low, close, volume और adjclose के साथ prices[]; डिविडेंड और स्प्लिट के लिए eventsData
- range 1d…max और interval 1m…3mo, या सटीक backfill के लिए absolute period1/period2 सीमाएँ
- न्यूमेरिक raw वैल्यू और Yahoo की display स्ट्रिंग के साथ मुख्य आँकड़े ({raw: 38.59, fmt: "38.59"})
- कंपनी प्रोफ़ाइल: सेक्टर, इंडस्ट्री, वेबसाइट, कर्मचारियों की संख्या, पता, अधिकारियों की लिस्ट
- मॉड्यूल के हिसाब से फ़ंडामेंटल्स: वार्षिक और तिमाही बैलेंस शीट, कैश फ़्लो, आय विवरण, earnings इतिहास और ट्रेंड
- /auto-complete से सिंबल लुकअप – फ़्री टेक्स्ट भेजें, एक्सचेंज के साथ सिंबल पाएँ
- बारह region: US, BR, AU, CA, FR, DE, HK, IN, IT, ES, GB, SG, मेल खाते lang कोड के साथ
टीमें ऐतिहासिक डेटा के लिए Yahoo Finance API से क्या बनाती हैं
बैकटेस्टिंग और क्वांट रिसर्च
सिंबल के एक समूह के लिए 10y या max दैनिक इतिहास डाउनलोड करें, adjclose सेव करें, और factor या momentum स्टडी चलाएँ। जब सिर्फ़ मोटे बार चाहिए हों और छोटे payload चाहिए, तो 1wk या 1mo interval इस्तेमाल करें।
पोर्टफ़ोलियो और नेट-वर्थ ट्रैकर
यूज़र इनपुट को auto-complete से resolve करें, फिर 1d इतिहास और summaryDetail से पोज़िशन रिफ़्रेश करें। regularMarketPreviousClose और dividendRate फ़ील्ड दैनिक P&L और आय के अनुमान में काम आते हैं।
फ़ंडामेंटल स्क्रीनर
मार्जिन, ग्रोथ या leverage पर कंपनियों को रैंक करने के लिए defaultKeyStatistics (profitMargins, enterpriseValue, heldPercentInstitutions) को fundamentals endpoint के incomeStatementHistory के साथ मिलाएँ।
रिसर्च डैशबोर्ड
अपना ख़ुद का filings पार्सर मेंटेन किए बिना प्रोफ़ाइल, कर्मचारियों की संख्या और सालों के तिमाही विवरण के साथ कंपनी कार्ड दिखाएँ।
ऐतिहासिक डेटा के लिए Yahoo Finance API: उदाहरण रिक्वेस्ट और रिस्पॉन्स
सिंबल से शुरू करें जैसा Yahoo उसे लिखता है – AAPL, SAP.DE, 0700.HK। अगर आपके पास सिर्फ़ कंपनी का नाम है, तो पहले GET /yho/auto-complete?q=apple कॉल करें; quotes[] symbol, exchange और quoteType लौटाता है, ताकि आप future या ETF के बजाय equity चुन सकें।
GET /yho/stock-v3-get-historical-data
curl "https://api.everydata.io/yho/stock-v3-get-historical-data?symbol=AAPL®ion=US&range=1mo&interval=1d" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"prices": [
{
"date": 1789738200,
"open": 337.9100036621094,
"high": 338.489990234375,
"low": 332.5299987792969,
"close": 336.1300048828125,
"volume": 86433100,
"adjclose": 336.1300048828125
},
{
"date": 1789651800,
"open": 334.7699890136719,
"high": 338.3399963378906,
"low": 330.17999267578125,
"close": 337,
"volume": 36700200,
"adjclose": 337
}
],
"isPending": false,
"firstTradeDate": 345479400,
"id": "AAPL",
"timeZone": {
"gmtOffset": -14400
},
"eventsData": [
{
"amount": 0.27,
"date": 1786368600,
"type": "DIVIDEND"
},
{
"amount": 0.27,
"date": 1778506200,
"type": "DIVIDEND"
}
]
}
eventsData माँगी गई range के भीतर के कॉरपोरेट एक्शन दिखाता है: हर नकद डिविडेंड {amount, date, type: "DIVIDEND"} के रूप में, लिस्टिंग मुद्रा में प्रति शेयर, और स्प्लिट splitRatio के साथ type "SPLIT" के रूप में। ऊपर के सैंपल में Apple ने छह महीने में दो बार $0.27 प्रति शेयर दिया। डिविडेंड इतिहास के लिए हर कैलेंडर वर्ष की राशियाँ जोड़ें, या total-return सीरीज़ ख़ुद बनाने के लिए उन्हें date से prices[] से जोड़ें।
prices[] सबसे नए से पुराने क्रम में है, Yahoo की historical-data टेबल की तरह। adjclose में स्प्लिट और डिविडेंड पहले से शामिल हैं, इसलिए रिटर्न की गणना के लिए इसे इस्तेमाल करें और जो कुछ छपी हुई क्लोज़िंग कीमत से मेल खाना चाहिए उसके लिए close। timeZone.gmtOffset सेकंड में एक्सचेंज का offset बताता है – -14400 US Eastern daylight time है – जिसकी ज़रूरत आपको non-US लिस्टिंग के लिए epoch तारीख़ों को वापस ट्रेडिंग दिनों में बदलने के लिए होती है।
Statistics और fundamentals Yahoo के quoteSummary envelope में आते हैं: quoteSummary.result[0].summaryDetail.trailingPE, {raw: 38.591274, fmt: "38.59"} है। गणना के लिए raw और दिखाने के लिए fmt पढ़ें। "yield": {} जैसे ख़ाली ऑब्जेक्ट का मतलब है कि इस इंस्ट्रूमेंट टाइप पर उस फ़ील्ड के लिए Yahoo के पास कोई वैल्यू नहीं है।
region, Yahoo संस्करण चुनता है, जो स्थानीय display स्ट्रिंग (region=DE पर typeDisp "Aktie") और सादे सिंबल के resolve होने के तरीके के लिए मायने रखता है। हर कॉल रियलटाइम है; बीच में कोई cache किया गया स्नैपशॉट नहीं है।
संबंधित endpoints
ऐतिहासिक डेटा. range/interval के साथ OHLCV इतिहास।
आँकड़े. मुख्य आँकड़े।
प्रोफ़ाइल. कंपनी प्रोफ़ाइल।
फ़ंडामेंटल्स. modules के ज़रिए बैलेंस शीट, कैश फ़्लो, आय विवरण और भी बहुत कुछ।
Auto complete. फ़्री टेक्स्ट से सिंबल लुकअप।
ऐतिहासिक डेटा के लिए Yahoo Finance API प्राइसिंग: प्रति रिक्वेस्ट भुगतान
एक रिक्वेस्ट एक endpoint कॉल के बराबर है, range चाहे जो हो – एक सिंबल का max-range दैनिक इतिहास उतना ही लेता है जितना 1d कॉल। फ़्री प्लान (हर महीने 100 रिक्वेस्ट) किसी कोर्स प्रोजेक्ट या प्रोटोटाइप के लिए काफ़ी है; Starter (5,000 रिक्वेस्ट, €30) statistics की गुंजाइश के साथ 150 सिंबल की वॉच लिस्ट रोज़ रिफ़्रेश करता है; Production (50,000, €80) कुछ हज़ार टिकर पर रात में fundamentals निकालना संभालता है। Yahoo की ओर के 5xx रिस्पॉन्स का कभी शुल्क नहीं लगता।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
ऐतिहासिक डेटा के लिए Yahoo Finance API: अक्सर पूछे जाने वाले सवाल
क्या कोई आधिकारिक Yahoo Finance API है?
अब नहीं। Yahoo ने 2017 में अपना सार्वजनिक Finance API बंद कर दिया, और कई पुराने ट्यूटोरियल के पीछे की YQL सेवा भी उसके साथ चली गई। अब बचे हैं वे JSON endpoint जिन्हें Yahoo की अपनी वेबसाइट इस्तेमाल करती है; yfinance या yahoo-finance2 जैसी लाइब्रेरी उन्हें अनौपचारिक रूप से कॉल करती हैं। everydata.io वही डेटा key, तय पैरामीटर और स्टेटस मॉनिटरिंग के साथ एक डॉक्यूमेंटेड REST API के रूप में देता है।
ऐतिहासिक डेटा में Adj Close और डिविडेंड कैसे पाएँ?
symbol, range और interval के साथ /yho/stock-v3-get-historical-data कॉल करें। prices[] की हर पंक्ति में close और adjclose दोनों होते हैं, और eventsData उसी range में डिविडेंड ({amount, date, type: "DIVIDEND"}) और स्प्लिट दिखाता है – दूसरी रिक्वेस्ट की ज़रूरत नहीं।
यह yfinance या yahoo-finance2 से कैसे अलग है?
वे ओपन-सोर्स लाइब्रेरी Yahoo के पेज आपकी अपनी मशीन से फ़ेच करती हैं, इसलिए cookies, consent पेज, rate limit और Yahoo की ओर के बदलाव आपकी समस्या हैं। यहाँ रिक्वेस्ट हमारी ओर चलती है, रिस्पॉन्स का आकार स्थिर रहता है, और upstream की विफल कॉल (5xx) का शुल्क नहीं लगता। फ़ील्ड के नाम Yahoo के JSON से मेल खाते हैं, इसलिए कोड पोर्ट करना ज़्यादातर बस URL बदलना है।
प्राइस इतिहास कितना पीछे तक जाता है?
जितना Yahoo के पास डेटा है – range=max, firstTradeDate से आगे का सब कुछ लौटाता है, जो AAPL के लिए 1980 है। दैनिक, साप्ताहिक और मासिक बार पूरा इतिहास कवर करते हैं; इंट्राडे interval (1m से 60m) उस हाल की अवधि तक सीमित हैं जो Yahoo अपने चार्ट पर दिखाता है।
non-US स्टॉक के लिए मैं कौन-सा सिंबल फ़ॉर्मैट इस्तेमाल करूँ?
Yahoo का suffix नोटेशन: Xetra के लिए SAP.DE, London के लिए VOD.L, Hong Kong के लिए 0700.HK, NSE के लिए RELIANCE.NS। पक्का न हो तो कंपनी के नाम के साथ /yho/auto-complete कॉल करें और quotes[] से symbol और exchDisp फ़ील्ड पढ़ें।
क्या रिस्पॉन्स का आकार Yahoo के अपने JSON जैसा ही है?
हाँ। Statistics, profile और fundamentals, {raw, fmt, longFmt} वैल्यू के साथ quoteSummary.result[] के रूप में आते हैं; ऐतिहासिक डेटा एक prices[] array है। Yahoo के स्ट्रक्चर पर लिखा मौजूदा कोड बिना दोबारा मैप किए काम करता है।
close और adjclose में क्या अंतर है?
close सेशन के अंत में छपी कीमत है। adjclose को स्प्लिट और नकद डिविडेंड के लिए पीछे से समायोजित किया जाता है, ताकि ऐतिहासिक रिटर्न तुलना योग्य रहें। परफ़ॉर्मेंस की गणना के लिए adjclose और स्टेटमेंट या चार्ट से मिलान के लिए close इस्तेमाल करें।
क्या यह रियलटाइम एक्सचेंज डेटा है?
यह वह डेटा है जो Yahoo Finance आपकी कॉल के समय सार्वजनिक रूप से दिखाता है। देरी Yahoo के लागू किए एक्सचेंज नियमों पर निर्भर है – कई US quotes रियलटाइम हैं, दूसरे 15 से 20 मिनट की देरी से। यह रिसर्च, डैशबोर्ड और एनालिटिक्स के लिए है, order routing के लिए लाइसेंस्ड फ़ीड के रूप में नहीं।
संबंधित उपयोग के उदाहरण
अपना पहला प्राइस इतिहास फ़ेच करें
फ़्री अकाउंट बनाएँ, key कॉपी करें और GET /yho/stock-v3-get-historical-data?symbol=AAPL&range=1y माँगें – हर महीने 100 रिक्वेस्ट, कार्ड नहीं।