موعد صدور CPI القادم
اعرف متى يصدر CPI الأمريكي القادم، بتوقيت UTC وبتوقيت نيويورك.
اقرأ الدليل ←تابع الإصدارات الاقتصادية المجدولة وحالة نشرها. أنشئ تقويم إصدارات للناتج المحلي الإجمالي والأسعار وسوق العمل والتجارة ومنحنيات العائد دون اعتبار المواعيد غير المؤكدة أوقاتًا دقيقة.
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"
}/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مصفوفةالأرقام المنشورة. تبقى المصفوفة فارغة حتى صدورها.
/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 الأمريكي القادم، بتوقيت UTC وبتوقيت نيويورك.
اقرأ الدليل ←أنشئ تقويمًا للإصدارات الخاصة بالدول والتواريخ التي تختارها.
اقرأ الدليل ←احصل على تذكير قبل الإصدار من خلاصة تقويم أو من سكربت يومي.
اقرأ الدليل ←حوّل أوقات الإصدار من UTC إلى الوقت المحلي مع مراعاة التوقيت الصيفي.
اقرأ الدليل ←اعرض قرارات الفائدة المجدولة لـ FOMC ومحاضر الاجتماعات.
اقرأ الدليل ←اعرض تواريخ قرارات البنوك المركزية بترتيب زمني.
اقرأ الدليل ←114 دولة. لـ 43 منها جداول إصدار تُقرأ من ناشريها مباشرة؛ وللـ 71 الأخرى تواريخ من تقويم طرف ثالث، موسومة بأنها استرشادية.
55 ناشراً رسمياً: مكاتب إحصاء ووزارات وبنوك مركزية. وتاريخ الناشر ورقمه لهما الغلبة دائماً على تقويم الطرف الثالث.
العطلات الرسمية حسب الدولة، بنطاق وطني وإقليمي.
استكشف API ←مؤشرات رسمية للأسعار والعمل والإنتاج والتجارة والفائدة.
استكشف API ←رصيد مدفوع مسبقاً، 2 دولار لكل 1,000 استدعاء، بلا خطط أو شرائح.
عرض الأسعار ←لا. قد تحدد الجهة الناشرة تاريخًا فقط، أو نطاقًا، أو موعدًا نهائيًا. تحتفظ الاستجابة بهذه الدقة في أحد الحقول at أو date أو between أو by في المستوى الأعلى.
استخدم المعلمة version_id في طلب تفاصيل الإصدار لاختيار نسخة غير قابلة للتغيير.
نعم. يحصل كل حساب في Narwhal على 10 دولارات من الرصيد المجاني كل شهر، بلا بطاقة وبلا تاريخ انتهاء. يكلّف طلب التقويم استدعاءً واحداً بسعر 2 دولار لكل 1,000 استدعاء، فيغطي الرصيد المجاني 5,000 استدعاء شهرياً.
نعم، حيث يتوفر ذلك في تقويم من طرف ثالث. تحمل القيمة التوقع بجانب الرقم السابق، وبعد الإصدار الرقم الفعلي. والتوقع تقدير وليس رقماً منشوراً، ويغيب عند عدم معرفته. لا يوجد تقييم للأهمية.
وقت الإصدار الدقيق، في الحقل at، يكون بتوقيت UTC. ويعطي الحقل timezone المنطقة الزمنية IANA الخاصة بالناشر، مثل Asia/Jakarta، لتتمكن من عرض الوقت المحلي. والإصدار الذي له تاريخ فقط لا وقت له.
يغطي الطلب نافذة حتى 366 يوماً. وتمتد النافذة الافتراضية من 30 يوماً قبل اليوم إلى 335 يوماً بعده. للنطاقات الأطول، اقرأ نافذة تلو الأخرى. والإصدار الذي تغيّر يحتفظ بنسخه السابقة، وتقرأها باستخدام version_id.
نعم. أنشئ اشتراكاً في التقويم فتعيد Narwhal رابط .ics خاصاً يمكن لتطبيق التقويم الاشتراك فيه. ويمكن أن يضم الإصدارات أو العطلات الرسمية أو كليهما، لـ 1 إلى 50 دولة ضمن نافذة حتى 366 يوماً. وإنشاؤه يكلّف استدعاءً واحداً.
نعم. يضم خادم Narwhal MCP الأداتين economics_list_releases وeconomics_get_release، وهما العمليتان نفسهما في نقطتي REST.
50 طلباً في الدقيقة ما دام الحساب يحمل رصيداً مجانياً فقط، و500 في الدقيقة متى حمل رصيداً مدفوعاً. ويُحدَّد عنوان الشبكة الواحد بـ 120 في الدقيقة. وتحمل استجابة 429 ترويسة Retry-After ولا تكلّف شيئاً.
لا يضمن الإصدار المجدول النشر في وقت دقيق. احتفظ بدقة التوقيت والمنطقة الزمنية، وتعامل مع الإصدارات الملغاة صراحةً. الوقت المجدول والوقت الذي رصد فيه Narwhal الإصدار يصفان حدثين مختلفين.
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.