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

Documentation Index

Fetch the complete documentation index at: https://benzinga-2-locadex-parallel-main.mintlify.app/llms.txt

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

نظرة عامة

اشترك في إعلانات الأرباح لحظة صدورها وتلقَّ تحديثات فورية حول النتائج المالية للشركات، بما في ذلك ربحية السهم والإيرادات ومفاجآت الأرباح.

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

  • أرباح في الوقت الفعلي: الحصول على تنبيهات فورية بإعلانات الأرباح عند حدوثها
  • بيانات شاملة: تتضمن ربحية السهم، والإيرادات، والتقديرات، والنتائج الفعلية، ومؤشرات مفاجأة الأرباح
  • التصفية حسب الورقة المالية: الاشتراك في رموز الأسهم أو أرقام التعريف الدولي للأوراق المالية ISIN محددة
  • فترات الأرباح: تتبّع نتائج Q1 وQ2 وQ3 وQ4، ونتائج السنة الكاملة (FY)
  • تقييمات الأهمية: مقياس من 0 إلى 5 يوضّح مدى أهمية الحدث للسوق

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

  • إنشاء تقاويم وتنبيهات أرباح في الوقت الفعلي
  • تتبّع مفاجآت الأرباح وأنماط التفوّق/الإخفاق مقابل التوقّعات
  • مراقبة أرباح شركات المحفظة الاستثمارية في الوقت الفعلي
  • إنشاء لوحات معلومات لموسم الأرباح
  • أتمتة استراتيجيات التداول بناءً على نتائج الأرباح

البدء السريع

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

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

wss://api.benzinga.com/api/v2.1/calendar/earnings/stream?token=YOUR_TOKEN

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

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

مثال للرسالة

{
  "id": "839f1f45-fffe-4801-9284-11dae5c5dae4",
  "api_version": "websocket/v1",
  "kind": "data/v2.1/calendar/earnings",
  "data": {
    "action": "created",
    "id": "66fffe978f3f630001a2ea56",
    "timestamp": "2024-10-04T14:42:27Z",
    "content": {
      "ticker": "AAPL",
      "name": "Apple Inc.",
      "exchange": "NASDAQ",
      "date": "2024-10-04",
      "time": "16:00:00",
      "period": "Q4",
      "period_year": 2024,
      "eps": "1.47",
      "eps_est": "1.39",
      "eps_surprise": "0.08",
      "eps_surprise_percent": "5.76",
      "revenue": "89500000000",
      "revenue_est": "89280000000",
      "importance": 5
    }
  }
}

الحقول الأساسية

الحقلالوصف
epsربحية السهم الفعلية المُبلَّغ عنها
eps_estتقدير ربحية السهم وفق إجماع المحللين
eps_surpriseالفرق بين القيمة الفعلية والتقدير
eps_surprise_percentقيمة المفاجأة كنسبة مئوية من التقدير
revenueالإيرادات الفعلية المُبلَّغ عنها
revenue_estتقدير الإيرادات وفق إجماع المحللين
importanceالأهمية في السوق (0-5، حيث 5 = الأعلى)

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

الإجراءالوصف
created / Createdإعلان أرباح جديد
updated / Updatedتعديل بيانات الأرباح
deleted / Deletedإزالة الإعلان

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

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

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

  • إزالة التكرار: استخدم الحقل id لمنع تكرار المعالجة
  • تصفية الأهمية: ركّز على الأرباح ذات الأهمية العالية (4–5) للتأثيرات الكبيرة في السوق
  • تنبيهات المفاجآت: اضبط حدودًا لمفاجآت الأرباح الكبيرة
  • التوقيت: لاحظ أن الحقل time يستخدم تنسيق 24 ساعة بتوقيت EST/EDT
Messages
token
type:httpApiKey

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

publish
type:string

Send action commands (ping, replay)

subscribe
type:object

Earnings event