جميع واجهات API

واجهة API للتقويم الاقتصادي

تابع الإصدارات الاقتصادية المجدولة وحالة نشرها. أنشئ تقويم إصدارات للناتج المحلي الإجمالي والأسعار وسوق العمل والتجارة ومنحنيات العائد دون اعتبار المواعيد غير المؤكدة أوقاتًا دقيقة.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
متاح94.13% uptime, last 30 أيام674 ms زمن الاستجابة المعتاد

الطلب الأول

عرض الإصدارات في شهر

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "revision": 0,
      "country": "USA",
      "series_id": "usa-consumer-prices",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "family": "prices",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}

ابحث عن قرار سعر الفائدة لبنك مركزي

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية
{
  "releases": [
    {
      "release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-monetary-policy-press-conference",
      "name": "Monetary policy press conference",
      "topic": "policy_communication",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:30:00Z",
      "timezone": "America/New_York",
      "values": []
    },
    {
      "release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:00:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}

اشتراكات التقويم

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'
استجابة نموذجية
{
  "subscription_id": "00000000-0000-4000-8000-000000000301",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2027-10-22T09:00:00Z"
}

نقاط النهاية

GETعرض الإصدارات/v1/economics/calendar

اعرض الإصدارات ضمن نطاق زمني.

المعلمات

  • countriesاختياري

    رموز ISO alpha-3، مثل USA. كرّر المعامل لعدة دول، بحد أقصى 50.

  • start_dateاختياري

    أول يوم في النافذة. تبدأ النافذة افتراضيًا قبل 30 يومًا من اليوم.

  • end_dateاختياري

    آخر يوم في النافذة. تنتهي افتراضيًا بعد 335 يومًا من اليوم. تمتد النافذة 366 يومًا على الأكثر.

  • limitاختياري

    عدد الإصدارات في الصفحة، من 1 إلى 100. القيمة الافتراضية 100.

  • cursorاختياري

    تابع باستخدام next_cursor والمرشحات نفسها.

كل إصدار في القائمة

  • release_idسلسلة نصية

    الإصدار المراد قراءة تفاصيله.

  • nameسلسلة نصية

    الاسم الإنجليزي القياسي في Narwhal، مثل Producer prices. لا يتضمن تواريخ.

  • topicسلسلة نصية

    ما تقيسه السلسلة، وهو نفسه في كل دولة، مثل consumer_prices أو gdp.

  • periodسلسلة نصية

    الفترة التي يغطيها الإصدار، مثل 2026-09 أو 2026-Q3.

  • statusسلسلة نصية

    حالة الإصدار، مثل scheduled.

  • at / date / between / byسلسلة نصية

    التوقيت الذي ذكرته الجهة الناشرة: وقت محدد أو يوم أو نطاق أيام أو موعد نهائي. تظهر القيمة None عندما يكون التاريخ مجهولًا.

  • valuesمصفوفة

    الأرقام المنشورة. تبقى المصفوفة فارغة حتى صدورها.


المرجع الكامل ‏←
GETجلب إصدار واحد/v1/economics/calendar/{release_id}

اقرأ إصدارًا، مع إمكانية تحديد version_id.

المعلمات

  • release_idمطلوب

    معرّف UUID الخاص بالإصدار.

  • version_idاختياري

    معرّف UUID لنسخة سابقة. بدونه تحصل على النسخة الحالية.

الإصدار

  • versionسلسلة نصية

    النسخة غير القابلة للتغيير، ويمكنك تمريرها لاحقًا باسم version_id.

  • nameسلسلة نصية

    الاسم الإنجليزي القياسي في Narwhal، مثل Producer prices. لا يتضمن تواريخ.

  • topicسلسلة نصية

    ما تقيسه السلسلة، وهو نفسه في كل دولة، مثل consumer_prices أو gdp.

  • periodسلسلة نصية

    الفترة التي يغطيها الإصدار، مثل 2026-09 أو 2026-Q3.

  • statusسلسلة نصية

    حالة الإصدار، مثل scheduled.

  • at / date / between / byسلسلة نصية

    التوقيت الذي ذكرته الجهة الناشرة: وقت محدد أو يوم أو نطاق أيام أو موعد نهائي. تظهر القيمة None عندما يكون التاريخ مجهولًا.

  • valuesمصفوفة

    الأرقام المنشورة. تبقى المصفوفة فارغة حتى صدورها.


المرجع الكامل ‏←

حالات الاستخدام

موعد صدور CPI القادم

اعرف متى يصدر CPI الأمريكي القادم، بتوقيت UTC وبتوقيت نيويورك.

اقرأ الدليل ‏←

تقويم اقتصادي

أنشئ تقويمًا للإصدارات الخاصة بالدول والتواريخ التي تختارها.

اقرأ الدليل ‏←

تنبيهات قبل الإصدار

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

اقرأ الدليل ‏←

أوقات الإصدار بتوقيتك

حوّل أوقات الإصدار من UTC إلى الوقت المحلي مع مراعاة التوقيت الصيفي.

اقرأ الدليل ‏←

اجتماعات FOMC ومحاضرها

اعرض قرارات الفائدة المجدولة لـ FOMC ومحاضر الاجتماعات.

اقرأ الدليل ‏←

اجتماعات البنوك المركزية

اعرض تواريخ قرارات البنوك المركزية بترتيب زمني.

اقرأ الدليل ‏←

التغطية

114 دولة. لـ 43 منها جداول إصدار تُقرأ من ناشريها مباشرة؛ وللـ 71 الأخرى تواريخ من تقويم طرف ثالث، موسومة بأنها استرشادية.

عرض كل الدول (114)

المصادر

55 ناشراً رسمياً: مكاتب إحصاء ووزارات وبنوك مركزية. وتاريخ الناشر ورقمه لهما الغلبة دائماً على تقويم الطرف الثالث.

  • Instituto Nacional de Estadística y Censos (INDEC)الأرجنتين
  • Australian Bureau of Statistics (ABS)أستراليا
  • Statistics Austriaالنمسا
  • Eurostat7 دولة
  • Statbelبلجيكا
  • National Bank of Belgiumبلجيكا
  • Banco Central do Brasilالبرازيل
  • National Statistical Institute (NSI)بلغاريا
  • Statistics Canadaكندا
  • Central Bank of Chile (BCCh)تشيلي
  • National Statistics Institute of Chile (INE)تشيلي
  • Croatian Bureau of Statistics (CBS)كرواتيا
عرض كل 55 مصدرًا
  • Czech Statistical Office (ČSÚ)تشيكيا
  • Statistics Denmarkالدنمارك
  • Statistics Estoniaإستونيا
  • European Commission (DG ECFIN)منطقة اليورو
  • Statistics Finlandفنلندا
  • Finnish Customs (Tulli)فنلندا
  • National Institute of Statistics and Economic Studies (INSEE)فرنسا
  • French Customsفرنسا
  • Federal Statistical Office of Germany (Destatis)ألمانيا
  • Hellenic Statistical Authority (ELSTAT)اليونان
  • Hungarian Central Statistical Office (KSH)المجر
  • Statistics Icelandآيسلندا
  • Ministry of Statistics and Programme Implementation (MoSPI)الهند
  • Central Statistics Office (CSO)أيرلندا
  • Italian National Institute of Statistics (Istat)إيطاليا
  • Statistics Bureau of Japanاليابان
  • Cabinet Office of Japanاليابان
  • Japan Customsاليابان
  • Central Statistical Bureau of Latvia (CSB)لاتفيا
  • State Data Agency of Lithuaniaليتوانيا
  • STATECلوكسمبورغ
  • Department of Statistics Malaysia (DOSM)ماليزيا
  • INEGIالمكسيك
  • Statistics Netherlands (CBS)هولندا
  • Stats NZنيوزيلندا
  • Statistics Norway (SSB)النرويج
  • Statistics Polandبولندا
  • Statistics Portugal (INE)البرتغال
  • National Bank of Romania (BNR)رومانيا
  • Federal State Statistics Service (Rosstat)روسيا
  • Bank of Russiaروسيا
  • Singapore Department of Statistics (SingStat)سنغافورة
  • Singapore government open-data publicationsسنغافورة
  • Statistical Office of the Republic of Slovenia (SURS)سلوفينيا
  • National Statistics Institute of Spain (INE)إسبانيا
  • Spanish Tax Agency (AEAT)إسبانيا
  • Statistics Sweden (SCB)السويد
  • Directorate-General of Budget, Accounting and Statistics (DGBAS)تايوان
  • Turkish Statistical Institute (TurkStat)تركيا
  • Office for National Statistics (ONS)المملكة المتحدة
  • Bureau of Labor Statistics (BLS)الولايات المتحدة
  • Bureau of Economic Analysis (BEA)الولايات المتحدة
  • US Census Bureauالولايات المتحدة

واجهات API ذات صلة

واجهة API للعطلات الرسمية

العطلات الرسمية حسب الدولة، بنطاق وطني وإقليمي.

استكشف API ‏←

واجهة API للاقتصاد

مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والفائدة.

استكشف API ‏←

الأسعار

رصيد مدفوع مسبقاً، 2 دولار لكل 1,000 استدعاء، بلا خطط أو شرائح.

عرض الأسعار ‏←

الأسئلة الشائعة

هل لكل إصدار وقت دقيق؟

لا. قد تحدد الجهة الناشرة تاريخًا فقط، أو نطاقًا، أو موعدًا نهائيًا. تحتفظ الاستجابة بهذه الدقة في أحد الحقول at أو date أو between أو by في المستوى الأعلى.

هل يمكنني استرجاع نسخة سابقة؟

استخدم المعلمة version_id في طلب تفاصيل الإصدار لاختيار نسخة غير قابلة للتغيير.

هل توجد واجهة API مجانية للتقويم الاقتصادي؟

نعم. يحصل كل حساب في Narwhal على 10 دولارات من الرصيد المجاني كل شهر، بلا بطاقة وبلا تاريخ انتهاء. يكلّف طلب التقويم استدعاءً واحداً بسعر 2 دولار لكل 1,000 استدعاء، فيغطي الرصيد المجاني 5,000 استدعاء شهرياً.

هل يتضمن التقويم توقعات الإجماع؟

نعم، حيث يتوفر ذلك في تقويم من طرف ثالث. تحمل القيمة التوقع بجانب الرقم السابق، وبعد الإصدار الرقم الفعلي. والتوقع تقدير وليس رقماً منشوراً، ويغيب عند عدم معرفته. لا يوجد تقييم للأهمية.

ما المنطقة الزمنية لأوقات الإصدار؟

وقت الإصدار الدقيق، في الحقل at، يكون بتوقيت UTC. ويعطي الحقل timezone المنطقة الزمنية IANA الخاصة بالناشر، مثل Asia/Jakarta، لتتمكن من عرض الوقت المحلي. والإصدار الذي له تاريخ فقط لا وقت له.

ما حجم التاريخ الذي يعيده التقويم؟

يغطي الطلب نافذة حتى 366 يوماً. وتمتد النافذة الافتراضية من 30 يوماً قبل اليوم إلى 335 يوماً بعده. للنطاقات الأطول، اقرأ نافذة تلو الأخرى. والإصدار الذي تغيّر يحتفظ بنسخه السابقة، وتقرأها باستخدام version_id.

هل يمكنني الحصول على التقويم كخلاصة ICS؟

نعم. أنشئ اشتراكاً في التقويم فتعيد Narwhal رابط .ics خاصاً يمكن لتطبيق التقويم الاشتراك فيه. ويمكن أن يضم الإصدارات أو العطلات الرسمية أو كليهما، لـ 1 إلى 50 دولة ضمن نافذة حتى 366 يوماً. وإنشاؤه يكلّف استدعاءً واحداً.

هل يستطيع وكيل ذكاء اصطناعي قراءة التقويم عبر MCP؟

نعم. يضم خادم Narwhal MCP الأداتين economics_list_releases وeconomics_get_release، وهما العمليتان نفسهما في نقطتي REST.

ما حدود المعدل؟

50 طلباً في الدقيقة ما دام الحساب يحمل رصيداً مجانياً فقط، و500 في الدقيقة متى حمل رصيداً مدفوعاً. ويُحدَّد عنوان الشبكة الواحد بـ 120 في الدقيقة. وتحمل استجابة 429 ترويسة Retry-After ولا تكلّف شيئاً.

ما الذي يجب أن أتحقق منه قبل استخدام البيانات؟

لا يضمن الإصدار المجدول النشر في وقت دقيق. احتفظ بدقة التوقيت والمنطقة الزمنية، وتعامل مع الإصدارات الملغاة صراحةً. الوقت المجدول والوقت الذي رصد فيه Narwhal الإصدار يصفان حدثين مختلفين.