أنشئ تقويمًا اقتصاديًا عبر API التقويم الاقتصادي

نفّذ ذلك باستخدام واجهة API

استخدم التقويم الاقتصادي لمعرفة تواريخ الإصدار. لكل إصدار حقول للوقت والبلد والاسم، إضافة إلى الفترة والموضوع والحالة والمنطقة الزمنية. احتفظ بهذه الحقول مع الإصدار إذا احتاج منتجك أو لوحة المعلومات لديك إلى تفاصيل أكثر من الجدول المطبوع.

1. اضبط مفتاح API الخاص بك احصل على مفتاح مجاني واحفظه في متغير البيئة NARWHAL_API_KEY. يقرأ السكربت هذا المتغير ويرسل المفتاح بصيغة Authorization: Bearer YOUR_KEY إلى https://api.narwhalapi.com. يستخدم Narwhal المفتاح نفسه لواجهتَي REST وMCP.
2. اختر الدول والتواريخ مرّر المعامل countries أكثر من مرة مع start_date وend_date. يستخدم المثال USA وGBR وJPN للفترة من 9 إلى 13 نوفمبر 2026. غيّر قائمة الدول ووسيطات التاريخ إذا أردت جدولًا مختلفًا، وأبقِ الطلب موجّهًا إلى /v1/economics/calendar.
3. جلب الإصدارات وترتيبها شغّل سكربت Python بعد إتاحة مفتاحك في البيئة. يجمع الإصدارات عبر الصفحات، ويختار السجلات التي تحتوي على at، ويرتّب الوقت والبلد والاسم معًا. يعرض الجدول المطبوع الأوقات بالتوقيت UTC متبوعة بعدد الإصدارات في النطاق الزمني المطلوب.
   Python: إصدارات أسبوع لثلاث دول

   import os
   import requests
   
   HEADERS = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   
   
   def calendar(countries, start, end):
       cursor = None
       while True:
           params = {
               "countries": countries,
               "start_date": start,
               "end_date": end,
               "limit": 100,
           }
           if cursor:
               params["cursor"] = cursor
           r = requests.get(
               "https://api.narwhalapi.com/v1/economics/calendar",
               params=params,
               headers=HEADERS,
               timeout=10,
           )
           r.raise_for_status()
           body = r.json()
           yield from body["releases"]
           cursor = body.get("next_cursor")
           if not cursor:
               return
   
   
   rows = sorted(
       (x["at"], x["country"], x["name"])
       for x in calendar(["USA", "GBR", "JPN"], "2026-11-09", "2026-11-13")
       if "at" in x
   )
   for at, country, name in rows:
       print(at, country, name)
   print(len(rows), "releases")

4. اختر الحقول المراد عرضها اعرض at (UTC) وcountry وname وperiod وtopic وstatus وtimezone في تقويم أكمل. يطبع السكربت الوقت والبلد والاسم فقط. أبقِ stage متاحًا عندما تحتاج إلى التمييز بين نسخ الإصدار. تبقى المصفوفة values فارغة إلى أن تُنشر الأرقام، لذلك قد يظهر إصدار مجدول قبل أن تتوفر أرقامه.

استخدام الموقع أو تطبيق تقويم أو جدول بيانات

افتح التقويم الاقتصادي لقراءة الإصدارات على موقع Narwhal. توجد صفحة تقويم اقتصادي لكل بلد، فهذه طريقة مباشرة عندما تريد قراءة جدول بلد ما دون كتابة طلب.

يعرض تدفق التقويم الإصدارات نفسها في تطبيق التقويم لديك. اتبع تلقَّ تنبيهًا قبل صدور بيانات اقتصادية لهذه الطريقة. وإذا كنت تفضل جدول بيانات، فيمكنه حفظ مخرجات السكربت: وقت UTC والبلد واسم الإصدار. تبدأ طريقة الجدول من مخرجات الـ API، أما الموقع والتدفق فمتاحان عندما تريد قراءة الجدول بلا كود.

متى تستخدم كل خيار

لماذا يظهر الناتج المحلي الإجمالي مرتين للمملكة المتحدة؟

قد يتشارك إصداران من النشرة نفسها الوقت ذاته، ويميّز بينهما الحقل stage. فمثلًا قد يكون للتقدير الأول والرقم الشهري الموعد المجدول نفسه. يميّز الحقل أيضًا بين النسخ السريعة والأولية والأولى والنهائية، لذا قد يبدو اسم الإصدار ووقته وحدهما متطابقين لنسخ مختلفة.

اعرض stage أو release_id بجانب الاسم للتمييز بين الإدخالات. في 12 نوفمبر 2026 الساعة 07:00 UTC يتضمن جدول المملكة المتحدة الناتج المحلي الإجمالي مرتين. احتفظ بالإدخالين عند عرض إصدارات ذلك الجدول، مع إظهار النسخة أو المعرّف بجانب كل اسم.

كم إصدارًا يعيده طلب واحد؟

تعيد الصفحة ما يصل إلى 100 إصدار. استخدم limit لتحديد حجم الصفحة ومرّر cursor لمتابعة النتائج. الصفحة جزء من الجدول المطلوب؛ استخدم next_cursor لتعرف هل بقيت إصدارات أخرى لجمعها للدول والتواريخ نفسها.

تابع إلى أن تصبح next_cursor تساوي null أو فارغة. إذا أعادت الـ API الخطأ 409 cursor_expired، فأعد الطلب بدون المؤشر. أبقِ اختيار الدول والتواريخ في ذلك الطلب لتحصل على الجدول الذي طلبته من بدايته.

ما الدول التي يمكنني تضمينها في التقويم؟

احذف countries للحصول على كل الدول المغطاة، أو مرّر ما يصل إلى 50 رمز دولة. استخدم EMU لمنطقة اليورو.

يمرّر مثال Python قائمة دول، فتتحول إلى معاملات countries متكررة في الطلب. للحصول على تقويم لكل الدول، احذف هذا المعامل من الطلب. أبقِ نطاق التواريخ كما هو واجمع كل الصفحات قبل ترتيب الإصدارات حسب وقتها بالتوقيت UTC.

مثال حسابي: من 9 إلى 13 نوفمبر 2026

في الفترة من 9 إلى 13 نوفمبر 2026، احسب أولًا إدخالات الولايات المتحدة: تجارة الجملة، وأسعار المستهلك، والأجور والدخل، وطلبات إعانة البطالة، ومخزونات النفط، والمالية العامة، وأسعار المنتجين. فيكون للولايات المتحدة 7 إصدارات. ولليابان إنفاق الأسر وميزان المدفوعات، أي إصداران في النطاق نفسه.

احسب إدخالات الناتج المحلي الإجمالي للمملكة المتحدة بشكل منفصل. مع الإنتاج الإنشائي وتجارة السلع والخدمات والإنتاج الصناعي وإنتاج الخدمات، يكون للمملكة المتحدة 6 إصدارات من 9 إلى 13 نوفمبر 2026. اجمع أعداد الدول لتحصل على إجمالي الجدول.

اقرأ أوقات UTC بترتيب التواريخ. في 9 نوفمبر 2026: تجارة الجملة الأمريكية الساعة 15:00، وإنفاق الأسر الياباني 23:30، وميزان المدفوعات الياباني 23:50. وفي 10 نوفمبر 2026 تتشارك أسعار المستهلك الأمريكية والأجور والدخل الأمريكية الوقت 13:30. وفي 12 نوفمبر 2026: طلبات إعانة البطالة الأمريكية 13:30، ومخزونات النفط 17:00، والمالية العامة 19:00. وأسعار المنتجين الأمريكية في 13 نوفمبر 2026 الساعة 13:30.

أكثر ساعة ازدحامًا من 9 إلى 13 نوفمبر 2026 هي 07:00 UTC يوم 12 نوفمبر، مع الإصدارات الستة للمملكة المتحدة. وفي الجدول المرتب تشمل هذه المجموعة نسختَي الناتج المحلي الإجمالي إلى جانب الإنتاج الإنشائي وتجارة السلع والخدمات والإنتاج الصناعي وإنتاج الخدمات.