الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2.1
/
calendar
/
economics
يعيد بيانات calendar الاقتصادي
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/economics?token=' \
  --header 'accept: <accept>'
{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "يتتبع تقرير \"Challenger Job Cuts (YoY)\" نسبة التغير في عمليات التسريح التي يعلن عنها أصحاب العمل خلال شهر معين مقارنة بالشهر نفسه من العام السابق. يستخدم المستثمرون والمحللون هذا التقرير لقياس قوة سوق العمل واتخاذ قرارات استثمارية مستنيرة. ويمكن لبيانات هذا التقرير أيضًا أن تؤثّر في قيمة الدولار الأمريكي، حيث تُعَدّ الأرقام الأعلى من المتوقع سلبية، في حين تُعَدّ الأرقام الأقل من المتوقع إيجابية.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "يتتبع تقرير \"Challenger Job Cuts (YoY)\" نسبة التغير في عمليات التسريح التي يعلن عنها أصحاب العمل خلال شهر معين مقارنة بالشهر نفسه من العام السابق. يستخدم المستثمرون والمحللون هذا التقرير لقياس قوة سوق العمل واتخاذ قرارات استثمارية مستنيرة. ويمكن لبيانات هذا التقرير أيضًا أن تؤثّر في قيمة الدولار الأمريكي، حيث تُعَدّ الأرقام الأعلى من المتوقع سلبية، في حين تُعَدّ الأرقام الأقل من المتوقع إيجابية.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

التفويضات

​
token
string
query
مطلوب

الترويسات

​
accept
enum<string>
افتراضي:application/json
مطلوب

يحدد تنسيق الإرجاع. تعمل معلمات الاستعلام بالطريقة نفسها في كلا التنسيقين

الخيارات المتاحة:
application/json

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

​
page
integer
افتراضي:0

إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية، تقتصر قيم إزاحة الصفحة على المجال من 0 إلى 100000. قَيِّد نتائج الاستعلام باستخدام معلمات أخرى مثل التاريخ.

​
pagesize
integer

عدد النتائج المُرجَعة. الحد الأقصى 1000

النطاق المطلوب: x <= 1000
​
parameters[date]
string<YYYY-MM-DD>

تاريخ الاستعلام عن بيانات calendar. يُستخدم كصيغة مختصرة لـ date_from وdate_to إذا كان التاريخان متماثلين. القيمة الافتراضية هي أحدث تاريخ متاح

​
parameters[date_from]
string<YYYY-MM-DD>

تاريخ الاستعلام اعتبارًا من نقطة زمنية معيّنة

​
parameters[date_to]
string<YYYY-MM-DD>

تاريخ الاستعلام حتى نقطة زمنية معيّنة

​
parameters[importance]
enum<integer>

مستوى الأهمية الذي تتم التصفية بناءً عليه. يستخدم قيمة أكبر من أو تساوي مستوى الأهمية المحدد

الخيارات المتاحة:
1,
2,
3
​
parameters[updated]
integer

الطابع الزمني بنظام Unix (بتوقيت UTC) لآخر تحديث للسجلات. سيؤدي ذلك إلى فرض ترتيب الفرز بحيث يكون أكبر من أو يساوي الطابع الزمني المشار إليه

​
country
string<A-Z:3>

رمز الدولة المكوَّن من ثلاثة أحرف (مثل: USA، CAN، GBR)

​
event_category
string<csv>

فئة واحدة أو أكثر تفصل بينها فاصلة

الاستجابة

نجاح

​
economics
object[]