الانتقال إلى المحتوى الرئيسي
WSS
wss://api.benzinga.com/api/v2.1/calendar/ratings
stream
Messages
token
type:httpApiKey

Benzinga WebSocket API token (bz.production***)

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst ratings event

نظرة عامة

اشترك في التغييرات الفورية في تقييمات المحللين وتحديثات السعر المستهدف. راقب عمليات رفع التصنيف وخفضه وبدء التغطية وتعديلات السعر المستهدف في الوقت الفعلي.

الميزات الرئيسية

  • تقييمات فورية: الحصول على إشعارات فورية بتغييرات تقييمات المحللين
  • أهداف السعر: تتبّع أهداف الأسعار الحالية والسابقة مع التعديلات
  • تفاصيل المحلل: تتضمن اسم المحلل، الشركة، ومقاييس الدقة التاريخية
  • تصنيف الإجراء: ترقيات، تخفيضات، الإبقاء على التقييم، بدء التغطية، إعادة التأكيد
  • التصفية حسب الورقة المالية: الاشتراك في رموز تداول محددة أو أرقام التعريف الدولية للأوراق المالية ISIN

حالات الاستخدام

  • بناء تنبيهات وإشعارات لتغييرات التقييم في الوقت الحقيقي
  • تتبّع أداء شركات الأبحاث ودقّتها
  • مراقبة تغيّرات إجماع السعر المستهدف
  • إنشاء لوحات معلومات لترقيات وتخفيضات التقييم
  • أتمتة استراتيجيات التداول بناءً على قرارات المحللين

البدء السريع

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

عنوان URL للاتصال

wss://api.benzinga.com/api/v2.1/calendar/ratings/stream?token=YOUR_TOKEN

معاملات الاستعلام

المعاملإلزاميالوصف
tokenنعمرمز الوصول الخاص بك لواجهة برمجة تطبيقات ويب سوكيت من Benzinga (bz.production***)
tickersلاقائمة من رموز التداول مفصولة بفواصل (على سبيل المثال: AAPL,TSLA)
isinsلاقائمة من أرقام التعريف الدولية للأوراق المالية ISIN مفصولة بفواصل لتصفية النتائج

مثال للرسالة

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "action": "created",
    "id": "66fffdc08f3f630001a2ea51",
    "timestamp": "2024-10-04T19:21:06Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "10:37:52",
      "action_company": "Upgrades",
      "rating_current": "Buy",
      "rating_prior": "Neutral",
      "pt_current": "200.00",
      "pt_prior": "180.00",
      "analyst": "Goldman Sachs",
      "firm_id": "57f832ab6b87f600016fa383",
      "importance": 4
    }
  }
}

إجراءات التصنيف

الإجراءالوصف
Upgradesتحسين للتصنيف (مثال: محايد → شراء)
Downgradesخفض للتصنيف (مثال: شراء → احتفاظ)
Maintainsيظل التصنيف دون تغيير
Initiatesأول تغطية بتصنيف
Reiteratesتأكيد التصنيف القائم

إجراءات الرسائل

الإجراءالوصف
created / Createdتم نشر تقييم جديد
updated / Updatedتم تعديل التقييم
deleted / Deletedتمت إزالة التقييم

الأوامر التفاعلية

الأمرالوصف
pingالحفاظ على الاتصال نشطًا (يستجيب بـ pong)
replayإعادة عرض ما يصل إلى آخر 100 رسالة مخزنة في الذاكرة المؤقتة

أفضل الممارسات

  • تتبع التغييرات: قارن بين rating_current وrating_prior لاكتشاف الترقيات/التخفيضات
  • حركة السعر المستهدف: راقب pt_current مقابل pt_prior لمتابعة تغيّرات السعر المستهدف
  • سمعة المحلل: خذ في الاعتبار أهمية المؤسسة ودقتها التاريخية
  • عامل التصفية حسب الأهمية: ركّز على التقييمات ذات الأهمية العالية (4-5) لتحقيق أكبر تأثير