تدفق الأخبار

مقالات إخبارية وتحديثات لحظية من Benzinga.

​

نظرة عامة

اشترك في تحديثات الأخبار في الوقت الفعلي وتلقَّ إشعارات فورية عند نشر مقالات جديدة أو تحديث المقالات الحالية.

​

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

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

​

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

• إنشاء تغذيات أخبار في الوقت الفعلي لأوراق مالية محددة
• إنشاء تنبيهات للأخبار العاجلة حول أصول المحفظة
• تجميع الأخبار عبر عدة رموز أسهم
• تتبع معنويات الأخبار وحجمها لتوليد إشارات التداول

​

البدء السريع

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

​

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

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

​

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

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

​

مثال لرسالة

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "api_version": "websocket/v1",
  "kind": "news",
  "data": {
    "action": "created",
    "id": 36444586,
    "timestamp": "2024-01-01T13:35:14Z",
    "content": {
      "id": 36444586,
      "author": "Benzinga Insights",
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
      "teaser": "",
      "body": "Full article content...",
      "url": "https://www.benzinga.com/markets/options/24/01/36444586/...",
      "image": [
        {
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/..."
        }
      ],
      "channels": [
        {
          "name": "Options"
        }
      ],
      "stocks": [
        {
          "name": "AAPL",
          "cusip": "037833100",
          "isin": "US0378331005",
          "exchange": "NASDAQ"
        }
      ],
      "tags": [
        {
          "name": "BZI-AUOA"
        }
      ]
    }
  }
}

​

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

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

​

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

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

​

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

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