Thursday, July 16, 2026

Ticker और एक्सचेंज सही तरीके से (finlight API)

Kevin Bartsch

Ticker और एक्सचेंज सही तरीके से (finlight API)

Ticker के अनुसार समाचार फ़िल्टर करना सरल लगता है, जब तक आप हकीकत से नहीं टकराते: एक ही ticker अलग-अलग एक्सचेंजों पर अलग-अलग कंपनियों को दर्शा सकता है, और एक ही कंपनी दुनिया भर में कई ticker के तहत ट्रेड कर सकती है। इसे गलत कर बैठें तो आपकी "Apple" फ़ीड चुपचाप गलत कहानियों से भर जाती है।

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

ticker के अनुसार फ़िल्टर करना

सबसे तेज़ तरीका है संरचित tickers फ़िल्टर:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tickers": ["AAPL", "NVDA"],
    "includeEntities": true,
    "pageSize": 20
  }'

includeEntities: true पर ध्यान दें। यह finlight को हर लेख के लिए हल किया गया कंपनी डेटा लौटाने को कहता है, और यही वह चीज़ है जिससे आप पुष्टि कर पाते हैं कि आपने सही कंपनी से मिलान किया है।

हल की गई एंटिटीज़ पढ़ना

includeEntities चालू रहने पर, हर लेख के साथ एक companies ऐरे आता है। एक कंपनी कुछ ऐसी दिखती है:

{
  "companyId": 320,
  "name": "Apple Inc.",
  "ticker": "AAPL",
  "confidence": "0.98",
  "isin": "US0378331005",
  "openfigi": "BBG000B9XRY4",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "primaryListing": {
    "ticker": "AAPL",
    "exchangeCode": "NASDAQ",
    "exchangeCountry": "US"
  },
  "otherListings": [
    { "ticker": "APC", "exchangeCode": "XETRA", "exchangeCountry": "DE" }
  ]
}

कुछ फ़ील्ड सबसे अहम काम करते हैं:

  • primaryListing कंपनी की मुख्य लिस्टिंग है, जिसमें उसका exchangeCode और exchangeCountry होता है।
  • otherListings हर द्वितीयक लिस्टिंग रखता है। इसी से आप देख पाते हैं कि Apple जर्मनी के XETRA पर APC के रूप में भी ट्रेड करता है।
  • isin और openfigi विश्व-स्तर पर अद्वितीय पहचानकर्ता हैं। एक सादे ticker के विपरीत, ये ठीक एक ही सिक्योरिटी की ओर इशारा करते हैं, जो उन्हें आपके अपने डेटा से मिलान के लिए आदर्श बनाता है।
  • confidence आपको बताता है कि finlight कितना आश्वस्त है कि लेख वाकई इसी कंपनी के बारे में है।

सटीकता के साथ अस्पष्टता दूर करना

जब एक सादा ticker अस्पष्ट हो, तो उसे क्वेरी भाषा से संकीर्ण करें। आप एक्सचेंज पर या किसी अद्वितीय पहचानकर्ता पर फ़िल्टर कर सकते हैं:

ticker:AAPL AND exchange:NASDAQ
isin:US0378331005

isin या openfigi के अनुसार फ़िल्टर करने से अस्पष्टता पूरी तरह मिट जाती है, क्योंकि कंपनी चाहे कितने भी ticker के तहत ट्रेड करे, ये एक ही सिक्योरिटी पर हल होते हैं।

एक व्यावहारिक पैटर्न

पोर्टफ़ोलियो या वॉचलिस्ट से जुड़े काम के लिए, जिस पहचानकर्ता पर आपको सबसे अधिक भरोसा हो उसी पर मिलान करें:

  1. अगर आपके पास सिर्फ़ ticker हैं, तो tickers भेजें और includeEntities चालू करें, फिर पुष्टि करें कि primaryListing आपके अपेक्षित एक्सचेंज से मेल खाता है।
  2. अगर आपके पास ISIN या OpenFIGI id हैं, तो सटीक मिलान के लिए क्वेरी में isin: / openfigi: से फ़िल्टर करें।
  3. finlight के companyId को अपने रिकॉर्ड के साथ संग्रहीत करें ताकि भविष्य की खोज अस्पष्टता-रहित रहे।

आगे कहाँ जाएँ

अपनी मुफ़्त API key पाएँ →