الانتقال إلى المحتوى الرئيسي
WSS
stream

Documentation Index

Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt

Use this file to discover all available pages before exploring further.

نظرة عامة

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

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

  • تحديثات آنية: احصل على إشعارات فورية عندما ينشر المحللون رؤى جديدة أو يحدِّثون التقييمات الحالية
  • التصفية حسب الورقة المالية: اشترك في رموز تداول أسهم محددة أو أرقام التعريف الدولي للأوراق المالية 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 لتقليل استهلاك النطاق الترددي
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Analyst insight event