Messages
{}No examples foundبيانات التقويم
تدفق تقييمات الإجماع
تقييمات الإجماع والأسعار المستهدفة المُجمَّعة في الوقت الفعلي.
WSS
stream
نظرة عامة
الميزات الرئيسية
- إجماع مجمّع: عرض موحّد لجميع تصنيفات المحللين لورقة مالية
- إجماع السعر المستهدف: متوسط الأسعار المستهدفة ونطاقها (الأعلى والأدنى)
- توزيع التصنيفات: توزيع حسب شراء قوي، شراء، احتفاظ، بيع، بيع قوي
- عدد المحللين: تتبّع العدد الإجمالي وعدد المحللين الفريدين الذين يغطّون الورقة المالية
- تجميع مرن: عرض كقيم عددية أو كنسب مئوية
حالات الاستخدام
- إنشاء لوحات معلومات وأدوات واجهة لإجماع التقييمات
- تتبّع تغيّرات اتجاه المحللين
- مقارنة التقييمات الفردية مع الإجماع
- مراقبة نطاقات السعر المستهدف (المرتفع، المنخفض، المتوسط)
- تحديد الأوراق المالية التي يشهد إجماع التقييمات عليها تحسّنًا أو تراجعًا
البدء السريع
رابط الاتصال 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لإجراء مقارنات معيارية
Messages
{}No examples foundtoken
type:httpApiKey
Benzinga WebSocket API token (bz.production***)
publish
type:string
Send action commands (ping, replay)
subscribe
type:object
Consensus ratings event
هل كانت هذه الصفحة مفيدة؟