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

يعيد بيانات إجمالية عن توصيات المحللين الإجماعية لرمز تداول معيّن. يوفّر هذا المسار أسعارًا مستهدفة إجمالية (إجماعية)، وتوزيعًا إجماليًا للتقييمات، وأعداد المحللين استنادًا إلى أحدث توصيات المحللين.

GET /api/v1/consensus-ratings

يُرجِع بيانات إجماع تصنيفات المحللين

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v1/consensus-ratings?token=' \
  --header 'accept: <accept>'

استجابة (200 OK)

{
  "aggregate_ratings": {
    "strong_buy": 7,
    "buy": 12,
    "hold": 5,
    "sell": 2
  },
  "aggregate_type": "number",
  "low_price_target": 200,
  "high_price_target": 350,
  "consensus_price_target": 293.69192307692305,
  "consensus_rating_val": 3.923076923076923,
  "consensus_rating": "BUY",
  "updated_at": "2026-01-05T19:42:36Z",
  "total_analyst_count": 50,
  "unique_analyst_count": 26
}

استجابة (200 OK)

{
  "aggregate_ratings": {
    "strong_buy": 7,
    "buy": 12,
    "hold": 5,
    "sell": 2
  },
  "aggregate_type": "number",
  "low_price_target": 200,
  "high_price_target": 350,
  "consensus_price_target": 293.69192307692305,
  "consensus_rating_val": 3.923076923076923,
  "consensus_rating": "BUY",
  "updated_at": "2026-01-05T19:42:36Z",
  "total_analyst_count": 50,
  "unique_analyst_count": 26
}

التفويضات

token · string · query · مطلوب

الترويسات

accept · enum<string> · افتراضي: application/json · مطلوب

يحدّد تنسيق الإرجاع. تعمل معاملات الاستعلام بالطريقة نفسها في كلا التنسيقين

الخيارات المتاحة: application/json

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

pagesize · integer

عدد النتائج المُرتجَعة. الحد الأقصى 1000

parameters[date_from] · string<YYYY-MM-DD>

تاريخ بدء الاستعلام من نقطة زمنية معينة

parameters[date_to] · string<YYYY-MM-DD>

تاريخ تنفيذ الاستعلام حتى نقطة زمنية معيّنة

parameters[tickers] · string

رمز تداول واحد للاستعلام عن البيانات المجمّعة له. الحد الأقصى رمز تداول واحد

simplify · boolean · افتراضي: false

لتبسيط التصنيفات المجمَّعة إلى BUY وSELL وHOLD فقط، فإن السلوك الافتراضي سيُرجِع جميع التصنيفات (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL)

aggregate_type · enum<string> · افتراضي: number

لتجميع التقييمات إما حسب العدد أو حسب النسبة المئوية

الخيارات المتاحة: number, percentage

الاستجابة

200

application/json

نجاح

aggregate_ratings · object

إظهار السمات الفرعية

aggregate_type · string

consensus_price_target · number

consensus_rating · string

consensus_rating_val · number

high_price_target · number

low_price_target · number

total_analyst_count · integer

unique_analyst_count · integer

updated_at · string