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

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Bull/Bear case event

نظرة عامة

اشترك في تحليلات فورية للحالات الصعودية والهبوطية للأوراق المالية. احصل على رؤى متوازنة حول السيناريوهات الإيجابية (الصعودية) والسيناريوهات السلبية (الهبوطية) للأسهم.

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

  • تحليل متوازن: تلقَّ السيناريوهات الصعودية والهبوطية للحصول على رؤية شاملة للسوق
  • تحديثات في الوقت الفعلي: تلقَّ إشعارات فورية عند إنشاء السيناريوهات أو تحديثها أو إزالتها
  • التصفية حسب الأداة المالية: اشترك في رموز تداول معيّنة أو أرقام التعريف الدولي للأوراق المالية ISIN محددة
  • معنويات السوق: افهم وجهات النظر المتفائلة والمتشائمة على حد سواء

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

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

البدء السريع

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

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

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

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

المعاملمطلوبالوصف
tokenYesرمز الوصول الخاص بك لواجهة برمجة التطبيقات ويب سوكيت من Benzinga (bz.production***)
tickersNoقائمة من رموز التداول مفصولة بفواصل (مثل AAPL,TSLA)
isinsNoقائمة من أرقام التعريف الدولية للأوراق المالية ISIN مفصولة بفواصل لتصفية النتائج

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

{
  "id": "websocket123",
  "api_version": "websocket/v1",
  "kind": "bull_bear_case",
  "data": {
    "action": "created",
    "id": "case123",
    "timestamp": "2024-10-01T10:00:00Z",
    "content": {
      "bull_case": "Strong earnings growth and market expansion expected.",
      "bear_case": "Increased competition and regulatory pressures.",
      "ticker": "AAPL",
      "updated": 1696153200
    }
  }
}

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

الإجراءالوصف
created / Createdتم نشر حالة صعودية/هبوطية جديدة
updated / Updatedتم تعديل حالة قائمة
deleted / Deletedتمت إزالة الحالة

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

الأمرالوصف
pingإبقاء الاتصال فعالًا (يرد بـ pong)
replayإعادة إرسال حتى آخر 100 رسالة مخزنة

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

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