ट्रेडिंग सिस्टम के लिए News API
दो स्ट्रीम, एक लेख। Raw स्ट्रीम हेडलाइन उसी क्षण देती है जब finlight उसे इन्जेस्ट करता है। एनरिच्ड स्ट्रीम लगभग 28 सेकंड बाद सेंटिमेंट, टिकर और एंटिटीज़ के साथ आती है। आपका सिस्टम पहले प्रतिक्रिया करता है और बाद में परिष्कृत करता है।
यह कैसे काम करता है
एक ही लेख, दो बार
ड्यूअल-स्ट्रीम पैटर्न वायर पर ऐसा दिखता है। पहले raw मैसेज, फिर उसी लेख का एनरिच्ड वर्शन, link द्वारा मैच किया गया।
{
"title": "S&P 500, Dow futures inch up as MidEast hopes offset SpaceX, AMD drag",
"link": "https://www.reuters.com/business/...",
"source": "www.reuters.com",
"summary": "Contracts tracking the S&P 500 and the Dow edged up on Wednesday ...",
"language": "en",
"publishDate": "2026-08-05T09:32:26.959Z",
"createdAt": "2026-08-05T09:32:41.103Z"
}{
"title": "S&P 500, Dow futures inch up as MidEast hopes offset SpaceX, AMD drag",
"link": "https://www.reuters.com/business/...",
"sentiment": "positive",
"confidence": "0.9702919721603394",
"categories": ["business", "markets"],
"countries": ["US"],
"companies": [
{
"ticker": "NVDA",
"name": "NVIDIA Corporation",
"exchange": "XNAS",
"isin": "US67066G1040"
},
{
"ticker": "AMD",
"name": "Advanced Micro Devices, Inc.",
"exchange": "XNAS",
"isin": "US0079031078"
}
]
}पेलोड संक्षिप्त हैं। प्रत्येक कंपनी एंटिटी में प्राइमरी लिस्टिंग और एक्सचेंज (MIC कोड) के अनुसार क्रॉस-लिस्टिंग होती है, इसलिए एक लेख बाज़ारों भर के इंस्ट्रूमेंट्स से मैप होता है। पूर्ण फ़ील्ड रेफ़रेंस docs में है। docs.
शुरू करें
आपकी भाषा में ड्यूअल-स्ट्रीम पैटर्न
एक क्लाइंट से दोनों स्ट्रीम सब्सक्राइब करें। Raw मैसेज पर प्रतिक्रिया करें, पूरा डेटा आने पर एनरिच करें। बस API कुंजी चाहिए।
import { FinlightApi } from 'finlight-client'
const api = new FinlightApi(
{ apiKey: process.env.FINLIGHT_API_KEY! },
{ takeover: true },
)
const seen = new Map<string, number>()
// Raw stream: instant delivery, react immediately
api.rawWebsocket.connect({ language: 'en' }, (raw) => {
seen.set(raw.link, Date.now())
if (/earnings|acquisition|merger|FDA|rate decision/i.test(raw.title)) {
console.log(`[SIGNAL] ${raw.title} (${raw.source})`)
// your reaction logic here
}
})
// Enriched stream: sentiment, entities, tickers
api.websocket.connect({ language: 'en', includeEntities: true }, (article) => {
const t = seen.get(article.link)
const delta = t ? `${((Date.now() - t) / 1000).toFixed(1)}s after raw` : 'new'
console.log(`[ENRICHED] ${article.title} (${delta})`)
console.log(
` sentiment=${article.sentiment} confidence=${article.confidence}`,
)
console.log(` tickers=${article.companies?.map((c) => c.ticker).join(',')}`)
seen.delete(article.link)
})SDK रीकनेक्शन, हार्टबीट और कनेक्शन रोटेशन संभालते हैं। npm install finlight-client या pip install finlight-client से इंस्टॉल करें।
ईमानदार तुलना
अगर आप यह स्वयं बनाते तो
एक स्क्रैपर फ़्लीट और RSS पोलर से हेडलाइन मिल जाती है, और बिना डिडुप्लिकेशन ज़रूरत वाले एक स्रोत के लिए यह सही हो सकता है। लागत बाद में दिखती है: एक ही कहानी पाँच एग्रीगेटर से पाँच बार आती है, पब्लिशर मार्कअप बदलने से रात 3 बजे पार्सर टूटते हैं, और एक सेंटिमेंट मॉडल जिसे अब आप अपनी रणनीति के साथ मेंटेन करते हैं। जेनेरिक News API स्क्रैपिंग हटाती हैं लेकिन शोर बना रहता है, क्योंकि टिकर मैपिंग और फ़ाइनेंस-रेलेवेंट सोर्स क्यूरेशन वही हिस्से हैं जो वे छोड़ देती हैं। finlight का काम वह बीच की परत है: डिडुप्लिकेटेड इन्जेशन, एंटिटी और टिकर टैगिंग, सेंटिमेंट, और एक स्ट्रीम आर्किटेक्चर जो प्रतिक्रिया गति को डेटा गहराई से अलग करता है।
लेटेंसी
"लगभग 28 सेकंड" का सटीक अर्थ
इस बाज़ार में लेटेंसी के दावे चार अलग-अलग क्लॉक मिला देते हैं: पब्लिशर ने कब पोस्ट किया, प्रोवाइडर ने लेख कब खोजा, कब इंडेक्स हुआ, और आप तक कब पहुँचा। हम एक संख्या प्रकाशित करते हैं, और वह आंतरिक रूप से मापी गई है: औसतन, raw स्ट्रीम एक लेख उसी लेख के एनरिच्ड वर्शन से लगभग 28 सेकंड पहले डिलीवर करती है। यह एनरिचमेंट पाइपलाइन की लागत है (सेंटिमेंट विश्लेषण, एंटिटी रेज़ोल्यूशन, टिकर मैचिंग), जिसे raw स्ट्रीम पूरी तरह छोड़ देती है। हम एंड-टू-एंड पब्लिकेशन-से-डिलीवरी आँकड़ा प्रकाशित नहीं करते, क्योंकि वह संख्या पब्लिशर टाइमस्टैम्प पर निर्भर करती है जो हमारे नियंत्रण में नहीं हैं। अगर कोई वेंडर आपको एक मिलीसेकंड आँकड़ा दे बिना बताए कि वह कौन सा क्लॉक माप रहा है, तो पूछें।
ड्यूअल-स्ट्रीम पैटर्न उस डेल्टा को फ़ायदे में बदलता है: raw मैसेज आपके सिस्टम को बताता है कि एक लेख मौजूद है और हेडलाइन फ़िल्टर तुरंत फ़ायर होने देता है। एनरिच्ड मैसेज तब आता है जब आपकी पोज़ीशन लॉजिक अभी भी सक्रिय है और सेंटिमेंट, कॉन्फ़िडेंस और टैग किए गए इंस्ट्रूमेंट्स जोड़ता है। अगर आपको सिर्फ़ कुछ लेखों के लिए एनरिचमेंट चाहिए, तो एनरिच्ड स्ट्रीम छोड़ें और ज़रूरी लेखों के लिए GET /v2/articles/by-link ऑन डिमांड कॉल करें।
Raw स्ट्रीम के पीछे की इंजीनियरिंग कहानी पढ़ें: How I Cut 28 Seconds Off Financial News Delivery
क्वेरी भाषा
स्रोत पर फ़िल्टर करें, अपने कोड में नहीं
स्ट्रीम और REST API एक ही क्वेरी भाषा साझा करते हैं। ticker:NVDA, exchange:NASDAQ, isin:US0378331005, सोर्स डोमेन, भाषा के अनुसार फ़िल्टर करें, पूर्ण बूलियन लॉजिक (AND, OR, NOT, कोष्ठक, -source:finance.yahoo.com जैसे एक्सक्लूज़न) के साथ। सर्वर-साइड फ़िल्टरिंग का मतलब है कि आपका सिस्टम केवल वही मैसेज प्रोसेस करता है जिन पर वह वैसे भी कार्रवाई करता।
(+ticker:TSLA OR +ticker:NVDA) AND ("earnings" OR "guidance") AND NOT cryptoविश्वसनीयता
बिना निगरानी चलने वाले सिस्टम के लिए बना
कनेक्शन शेड्यूल पर रोटेट होते हैं, इसलिए SDK हार्टबीट और रीकनेक्शन आपके लिए संभालते हैं। रेट लिमिट एज पर लागू होती हैं, इसलिए एक ख़राब व्यवहार करने वाला क्लाइंट आपकी फ़ीड ख़राब करने की बजाय तेज़ी से फ़ेल होता है। REST एक्सेस ऐतिहासिक क्वेरीज़ और बैकफ़िल कवर करता है, इसलिए वही क्वेरी जो आपकी लाइव स्ट्रीम चलाती है, आपकी रिसर्च नोटबुक भी चलाती है।
डेस्क-लेवल डिप्लॉयमेंट चला रहे हैं? कस्टम सोर्स, वार्षिक इनवॉइसिंग और प्राथमिकता ऑनबोर्डिंग उपलब्ध हैं। आप सोर्स का नाम बताएँ, हम उसे आपके अनुबंध के हिस्से के रूप में जोड़ देते हैं। हमसे संपर्क करें
मूल्य निर्धारण
स्ट्रीमिंग के लिए बने प्लान
स्ट्रीमिंग एक्सेस Pro Standard प्लान से शुरू होती है। प्लान अनुरोध वॉल्यूम, WebSocket कनेक्शन और डिस्पैच कोटा में भिन्न हैं।
Pro Standard
1 समवर्ती WebSocket कनेक्शन, स्ट्रीमिंग एक्सेस शामिल
Pro Scale
मल्टी-स्ट्रीम सेटअप के लिए 3 समवर्ती WebSocket कनेक्शन
सभी प्लान की तुलना करें मूल्य निर्धारण पृष्ठ
कनेक्ट करने के अन्य तरीक़े
WebSocket स्ट्रीमिंग से परे
ड्यूअल-स्ट्रीम पैटर्न एक इंटीग्रेशन है। finlight REST और webhook डिलीवरी भी प्रदान करता है।
अक्सर पूछे जाने वाले प्रश्न
ट्रेडिंग सिस्टम API प्रश्न
ट्रेडिंग सिस्टम इंटीग्रेशन के लिए finlight के उपयोग के बारे में सामान्य प्रश्न।
स्ट्रीमिंग एक्सेस Pro Standard प्लान से शुरू होती है। प्लान अनुरोध वॉल्यूम, WebSocket कनेक्शन और डिस्पैच कोटा में भिन्न हैं। वर्तमान मूल्य और सीमाएँ मूल्य निर्धारण पृष्ठ पर हैं।
अभी भी प्रश्न हैं?
हमारी डेवलपर-फर्स्ट सपोर्ट टीम इंटीग्रेट और स्केल करने में आपकी मदद के लिए यहां है।
अपनी सिग्नल लॉजिक के विरुद्ध परीक्षण करें
न्यूज़ फ़ीड का मूल्यांकन करने का सबसे तेज़ तरीक़ा है अपना फ़िल्टर उस पर लगाना। कुंजी लें, ड्यूअल-स्ट्रीम उदाहरण चलाएँ, और लाइव लेखों पर डेल्टा देखें।