الانتقال إلى المحتوى الرئيسي
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/news/stream?token=YOUR_TOKEN

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

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

مثال لرسالة

{
  "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)
  • التصفية: استخدم فلاتر رمز التداول/القناة لتقليل استهلاك النطاق الترددي
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

News Update
type:object

A news article or update message