Messages
{}No examples foundبيانات التقويم
تدفق الأرباح
إعلانات الأرباح والنتائج المالية آنية في الوقت الفعلي.
WSS
stream
نظرة عامة
الميزات الأساسية
- أرباح في الوقت الفعلي: الحصول على تنبيهات فورية بإعلانات الأرباح عند حدوثها
- بيانات شاملة: تتضمن ربحية السهم، والإيرادات، والتقديرات، والنتائج الفعلية، ومؤشرات مفاجأة الأرباح
- التصفية حسب الورقة المالية: الاشتراك في رموز الأسهم أو أرقام التعريف الدولي للأوراق المالية 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
{}No examples foundtoken
type:httpApiKey
Benzinga WebSocket API token (bz.production***)
publish
type:string
Send action commands (ping, replay)
subscribe
type:object
Earnings event
هل كانت هذه الصفحة مفيدة؟