استخدام رموز الأسهم والبورصات على نحو صحيح مع finlight API

استخدام رموز الأسهم والبورصات على نحو صحيح مع finlight API

تبدو تصفية الأخبار حسب رمز السهم أمرًا بسيطًا حتى تصطدم بالواقع: فالرمز نفسه قد يعني شركات مختلفة في بورصات مختلفة، والشركة الواحدة قد تتداول تحت عدة رموز حول العالم. وإن أخطأت في ذلك، فإن تدفّق أخبار "Apple" لديك سيمتلئ بهدوء بالقصص الخاطئة.

يحل finlight هذه المشكلة بتحليل كل شركة موسومة وربطها بمعرّفات حقيقية لا لبس فيها. يوضح هذا الدليل كيف تصفّي حسب رمز السهم وكيف تقرأ تلك المعرّفات لتستهدف الشركة الصحيحة دائمًا.

التصفية حسب رمز السهم

أسرع طريقة هي المرشّح المهيكل 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 تتداول أيضًا تحت APC في XETRA بألمانيا.
• isin و**openfigi** معرّفان فريدان عالميًا. فبخلاف رمز السهم المجرد، يشيران إلى ورقة مالية واحدة بالضبط، ما يجعلهما مثاليين للمطابقة مع بياناتك الخاصة.
• confidence يخبرك بمدى تأكد finlight من أن المقال يتعلق فعلًا بهذه الشركة.

إزالة الغموض بدقة

عندما يكون رمز السهم المجرد غامضًا، ضيّقه باستخدام لغة الاستعلام. يمكنك التصفية حسب البورصة أو حسب معرّف فريد:

ticker:AAPL AND exchange:NASDAQ

isin:US0378331005

التصفية حسب isin أو openfigi تزيل الغموض تمامًا، لأن كلًّا منهما يُحلَّل إلى ورقة مالية واحدة بغض النظر عن عدد الرموز التي تتداول الشركة تحتها.

نمط عملي

في العمل على المحافظ أو قوائم المتابعة، طابِق حسب المعرّف الذي تثق به أكثر:

1. إن كانت لديك رموز الأسهم فقط، أرسل tickers وفعّل includeEntities، ثم تأكد من أن primaryListing يطابق البورصة التي تتوقعها.
2. إن كانت لديك معرّفات ISIN أو OpenFIGI، صفِّ بـ isin: / openfigi: في الاستعلام لمطابقة دقيقة.
3. خزّن companyId من finlight إلى جانب سجلاتك لتصبح عمليات البحث المستقبلية بلا غموض.

إلى أين تذهب بعد ذلك

• التصفية المتقدمة: استعلامات دقيقة.
• الأخبار العالمية حسب الدولة والفئة.
• التوثيق الكامل.

احصل على مفتاح API المجاني ←