تدفق تقييمات الإجماع

تقييمات الإجماع والأسعار المستهدفة المُجمَّعة في الوقت الفعلي.

​

نظرة عامة

اشترك في تقييمات إجماع لحظية تجمع آراء عدد من المحللين في تقييمات موحّدة وأهداف سعرية. تتبّع معنويات السوق العامة والتغيّرات في إجماع المحللين.

​

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

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

​

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

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

​

البدء السريع

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

​

رابط الاتصال URL

wss://api.benzinga.com/api/v1/consensus-ratings/stream?token=YOUR_TOKEN

​

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

المعامل	إلزامي	الوصف
token	Yes	رمز الوصول الخاص بواجهة برمجة التطبيقات API عبر ويب سوكيت من Benzinga (bz.production***)
tickers	No	قائمة من رموز التداول مفصولة بفواصل (على سبيل المثال: AAPL,MSFT)
isins	No	قائمة من أرقام التعريف الدولي للأوراق المالية ISIN مفصولة بفواصل للتصفية
simplify	No	تبسيط التوصيات إلى: شراء، احتفاظ، بيع
aggregate_type	No	نوع التجميع: number أو percentage

​

مثال على رسالة

{
  "id": "e9e75b31-604e-422c-a532-362725b2d59d",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/ratings",
  "data": {
    "aggregate_ratings": {
      "strong_buy": 15,
      "buy": 25,
      "hold": 8,
      "sell": 2,
      "strong_sell": 0
    },
    "aggregate_type": "number",
    "consensus_rating": "BUY",
    "consensus_rating_val": 4.2,
    "consensus_price_target": 195.50,
    "high_price_target": 225.00,
    "low_price_target": 160.00,
    "total_analyst_count": 50,
    "unique_analyst_count": 48,
    "updated_at": "2024-10-04T19:21:06Z"
  }
}

​

تقييمات الإجماع

Rating	Numeric Value	Description
STRONG_BUY	5.0	إجماع صعودي قوي جدًا
BUY	4.0 - 4.9	إجماع صعودي
HOLD	3.0 - 3.9	إجماع محايد
SELL	2.0 - 2.9	إجماع هبوطي
STRONG_SELL	1.0 - 1.9	إجماع هبوطي قوي جدًا

​

المقاييس الرئيسية

Field	Description
consensus_rating	التقييم الإجمالي (BUY, HOLD, SELL)
consensus_rating_val	القيمة الرقمية للتقييم (1.0-5.0)
consensus_price_target	متوسط السعر المستهدف من قِبل المحللين
high_price_target	أعلى سعر مستهدف
low_price_target	أدنى سعر مستهدف
total_analyst_count	العدد الإجمالي للتقييمات
unique_analyst_count	عدد المحللين المختلفين

​

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

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

​

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

• تغيُّرات الإجماع: راقب تغيُّرات consensus_rating_val بمرور الوقت
• نطاق السعر المستهدف: قارن السعر الحالي بأعلى وأدنى سعر مستهدف للحصول على سياق للتقييم
• عمق التغطية: ارتفاع عدد المحللين يشير إلى إجماع أكثر موثوقية
• تحليل التوزيع: افحص تفصيل aggregate_ratings لفهم أدق لمعنويات السوق
• عرض النسب المئوية: استخدم aggregate_type=percentage لإجراء مقارنات معيارية