الانتقال إلى المحتوى الرئيسي
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": "العمالة",
      "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": "العمالة",
      "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>

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

الاستجابة

نجاح

استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للأحداث الاقتصادية

​
economics
object[]