الانتقال إلى المحتوى الرئيسي
WSS
wss://api.benzinga.com/api/v1/analyst/insights
stream
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst insight event

نظرة عامة

اشترك في تحليلات المحللين في الوقت الفعلي وتلقَّ تحديثات حول تصنيفات المحللين، والأسعار المستهدفة، والتوصيات المفصلة فور صدورها.

الميزات الأساسية

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

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

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

البدء السريع

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

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

wss://api.benzinga.com/api/v1/analyst/insights/stream?token=YOUR_TOKEN

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

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

مثال للرسالة

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "stream_type",
  "data": {
    "action": "created",
    "id": "insight-id",
    "timestamp": "2024-10-08T10:00:00Z",
    "content": {
      "action": "Upgrades",
      "analyst_insights": "قام المحلل برفع تصنيف السهم...",
      "firm": "Goldman Sachs",
      "pt": "150.00",
      "rating": "Buy",
      "security": {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "exchange": "NASDAQ"
      }
    }
  }
}

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

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

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

CommandDescription
pingإبقاء الاتصال نشطًا (يستجيب بـ pong)
replayإعادة عرض ما يصل إلى آخر 100 رسالة مخزنة مؤقتًا

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

  • إزالة التكرارات: استخدم حقل id لمنع معالجة الرسائل المكررة
  • نبضات الاتصال (Heartbeat): أرسل أوامر ping كل 30–60 ثانية للحفاظ على الاتصال
  • التعامل مع الأخطاء: طبّق منطق إعادة الاتصال مع استراتيجية تراجع أسي
  • التصفية: استخدم مرشحات رمز التداول/رقم التعريف الدولي للأوراق المالية ISIN لتقليل استهلاك النطاق الترددي