حساب التضخم السنوي والشهري من مؤشر أسعار المستهلك

احصل على معدلات CPI باستخدام API

1. إعداد مفتاح API الخاص بك احصل على مفتاح مجاني واحتفظ به في متغير بيئة اسمه NARWHAL_API_KEY. تستخدم الطلبات عنوان URL الأساسي https://api.narwhalapi.com والترويسة Authorization: Bearer YOUR_KEY؛ ويشترك REST وMCP في المفتاح نفسه.
2. اقرأ معدلات التضخم الجاهزة استخدم نقطة نهاية التضخم للحصول على year_over_year وmonth_over_month وyear_to_date وreleased_on. المعدلات سلاسل عشرية معبَّر عنها بالنسبة المئوية، لذا استخدم المعدل المعاد مباشرة عندما تحتاج إلى الرقم الرئيسي لتلك الفترة.
   curl، المعدلات الجاهزة

   curl -s -H "Authorization: Bearer $NARWHAL_API_KEY" \
     "https://api.narwhalapi.com/v1/economics/USA/inflation"

3. احسب معدلًا من مستويات المؤشر تعيد نقطة نهاية ملاحظات CPI صفوف period وvalue مع ضبط index_base على 1982-84=100. يبحث هذا السكربت عن الشهر السابق ونفس الشهر قبل سنة بحسب period، ثم يحسب المعدل عندما تتوافر الملاحظات المطلوبة.
   Python، التغير الشهري من مستويات المؤشر

   import os
   import requests
   
   r = requests.get(
       "https://api.narwhalapi.com/v1/economics/USA/cpi/observations",
       params={"start": "2025-09", "limit": 24},
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   )
   r.raise_for_status()
   cpi = {o["period"]: float(o["value"]) for o in r.json()["observations"]}
   
   latest = max(cpi)  # "2026-09"
   year, month = latest.split("-")
   prev_month = f"{year}-{int(month) - 1:02d}" if month != "01" else f"{int(year) - 1}-12"
   prev_year = f"{int(year) - 1}-{month}"
   
   print("MoM %.2f%%" % ((cpi[latest] / cpi[prev_month] - 1) * 100))
   print(
       "YoY %.2f%%" % ((cpi[latest] / cpi[prev_year] - 1) * 100)
       if prev_year in cpi
       else "year-ago month not in range"
   )

4. اقرأ الفترات المعادة يقرأ كل حساب السجل الكامل. تخبرك أول فترة مُرجَعة بمكان بداية السلسلة ومكان إمكانية بدء حسابك.

للتغير الشهري، اقسم مؤشر أسعار المستهلك لهذا الشهر على مؤشر الشهر الماضي، ثم اطرح واحدًا واضرب في 100. وللتغير السنوي، استخدم الشهر نفسه قبل عام مقامًا. كما تُرجع نقطة نهاية التضخم المعدلين العامين جاهزين في year_over_year وmonth_over_month.

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

احسب تغيرات CPI في جدول أو اقرأ المعدلات دون كود

في Google Sheets، نسّق العمود A كنص عادي عبر Format ثم Number ثم Plain text قبل لصق الفترات. فقد يحوّل Sheets القيمة 2026-09 إلى تاريخ، فيفشل البحث النصي. ضع نص الفترة في العمود A وقيمة CPI المقابلة في العمود B. واستخدم الترتيب نفسه للفترة والقيمة في صيغة Excel.

=VLOOKUP("2026-09",A:B,2,FALSE)/VLOOKUP("2026-08",A:B,2,FALSE)-1

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

لحساب سبتمبر 2026 منذ بداية العام في جدول، ابحث عن سبتمبر 2026 وديسمبر 2025 بحسب period واستخدم هذين المستويين في القسمة نفسها. يتغير المقام إلى مستوى ديسمبر، ويبقى الطرح وتنسيق النسبة المئوية كما هما.

اختر خيار CPI المناسب لحسابك

لماذا يختلف حساب CPI عندي عن المعدل المنشور؟

تقرّب الجهات الناشرة المؤشر والمعدل كلًّا على حدة، لذلك قد يختلف الحساب من مستويات المؤشر في الخانة العشرية الثانية. بالنسبة إلى سبتمبر 2026، تعطي قسمة 336.940 على 334.980 المعدل الشهري في المثال المحلول. يعرض حساب Python خانتين عشريتين، بينما يستخدم المعدل الشهري في API خانة عشرية واحدة. ضع دقة الحساب ودقة المعدل المعاد في اعتبارك عند المقارنة بين الرقمين.

ماذا لو غاب شهر من CPI؟

لا تُجرِ استيفاءً للشهر الغائب أبدًا. في مثال سبتمبر 2026، تبدأ السلسلة الأمريكية في نوفمبر 2025، وملاحظة أكتوبر 2025 غير موجودة في السلسلة. لا تفترض أن الاستجابة تضم 13 صفًا شهريًا متصلًا. ولا يجعل الطلب الأوسع الملاحظة الغائبة متاحة؛ أبقِ عمليات البحث مرتبطة بالفترة التي تحتاج إليها.

في مثال سبتمبر 2026، يطبع نص Python البرمجي المعدلين الشهري والسنوي بمنزلتين عشريتين. استخدم نقطة نهاية التضخم للحصول على المعدل السنوي العام.

هل يمكنني تحويل معدل CPI الشهري إلى معدل سنوي؟

نعم. استخدم (1 + MoM)^12 - 1 مع التعبير عن MoM بصيغة عشرية لتحويل المعدل الشهري إلى سنوي. بالنسبة إلى سبتمبر 2026، يعطي الحساب الشهري في المثال المحلول النتيجة السنوية المذكورة هناك. أما المعدل السنوي على أساس سنة مقابل سنة فيستخدم المؤشر الفعلي للشهر نفسه قبل سنة، لذا أبقِ هذا الحساب منفصلًا عن تحويل معدل شهري إلى سنوي.

مثال محلول: CPI الأمريكي لسبتمبر 2026

ابدأ بـ CPI سبتمبر 2026 البالغ 336.940 وCPI أغسطس 2026 البالغ 334.980. اقسم مستوى سبتمبر على مستوى أغسطس، واطرح واحدًا واضرب في 100 لتحسب التغير الشهري. ولحساب التغير منذ بداية العام، استخدم CPI ديسمبر 2025 البالغ 324.054 مقامًا وطبّق الصيغة نفسها.

في استجابة التضخم لسبتمبر 2026، تُضبط قيمة released_on على 2026-10-14. اقرأ حقل year_over_year للحصول على المعدل السنوي الرئيسي؛ أما مقارنة ديسمبر أعلاه فهي منذ بداية العام. وإذا انخفض CPI خلال الفترة التي اخترتها، يكون المعدل المحسوب سالبًا ويصف انخفاضًا في الأسعار.