تدفق الأرباح

إعلانات الأرباح والنتائج المالية آنية في الوقت الفعلي.

​

نظرة عامة

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

​

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

• أرباح في الوقت الفعلي: الحصول على تنبيهات فورية بإعلانات الأرباح عند حدوثها
• بيانات شاملة: تتضمن ربحية السهم، والإيرادات، والتقديرات، والنتائج الفعلية، ومؤشرات مفاجأة الأرباح
• التصفية حسب الورقة المالية: الاشتراك في رموز الأسهم أو أرقام التعريف الدولي للأوراق المالية 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