تغطي الزيادة الأسعار عندما تساوي تغيّر مؤشر أسعار المستهلك على أساس سنوي أو تفوقه. توفّر Narwhal التضخم لكل دولة، ويحوّل كود Python أدناه الزيادة ومعدل التضخم إلى تغيّر حقيقي؛ ولا تملك بيانات مرجعية للأجور في معظم الدول.
قراءة معدل التضخم لكل دولة
تعيد نقطة التضخم أحدث تغيّر سنوي وشهري في الأسعار لدولة ما. يطلب هذان الطلبان ألمانيا واليابان.
curl -s -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/DEU/inflation"{
"country": "DEU",
"period": "2026-09",
"year_over_year": "3.3",
"month_over_month": "0.6",
"year_to_date": "3.2",
"released_on": "2026-10-13"
}curl -s -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/JPN/inflation"{
"country": "JPN",
"period": "2026-09",
"year_over_year": "2.1",
"month_over_month": "0.0",
"year_to_date": "1.3",
"released_on": "2026-10-23"
}year_over_year هو التغيّر المئوي في مؤشر أسعار المستهلك مقابل الشهر نفسه قبل سنة، وهو هنا 3.3 لألمانيا و2.1 لليابان في أحدث شهر period. وmonth_over_month هو التغيّر منذ الشهر السابق، وyear_to_date هو التغيّر منذ ديسمبر. وreleased_on هو تاريخ النشر. القيم سلاسل عشرية بالنسبة المئوية.
التحقق المتبادل مع المؤشر
يمكن إعادة بناء المعدل نفسه من المؤشر. تعيد نقطة observations مؤشر أسعار المستهلك الشهري، وتُبقي الاستجابة أدناه على أول وآخر شهر من الأشهر الـ 13 التي أُعيدت لألمانيا.
curl -s -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/DEU/cpi/observations?start=2025-09&end=2026-09"{
"country": "DEU",
"as_of": "2026-10-13T00:00:00Z",
"index_base": "2020=100",
"observations": [
{
"period": "2025-09",
"value": "122.6"
},
{
"period": "2026-09",
"value": "126.6"
}
],
"next_cursor": null
}126.6 مقسومة على 122.6 تساوي 1.0326، أي أن المؤشر ارتفع 3.26 في المئة خلال 12 شهرًا، وهو ما يُقرَّب إلى 3.3 في year_over_year. ويعطي الفحص نفسه لليابان 2.10 في المئة من 102.2 و100.1.
مقارنة الزيادة بالأسعار
لا تملك Narwhal بيانات مرجعية للرواتب أو الأجور في معظم الدول، ولذلك تكتب هذه الصفحة جانب الأسعار فقط. أنت من يأتي بنسبة الزيادة. التغيّر الحقيقي هو واحد زائد الزيادة مقسومًا على واحد زائد التضخم، ناقص واحد. النتيجة الموجبة تعني أن الراتب يشتري أكثر مما قبل سنة، والسالبة تعني أنه يشتري أقل.
- احصل على نسبة الزيادة استخدم النسبة المئوية للتغيّر في الراتب بين الفترتين، وعلى الأساس نفسه في المرتين، مثل الراتب الشهري الإجمالي.
- قراءة التضخم اطلب التضخم للدولة واحتفظ بـ
periodوyear_over_year. - احسب النسبة اقسم واحدًا زائد الزيادة على واحد زائد التضخم، واطرح واحدًا، ثم اضرب في 100.
- أبلغ بالنتيجة اذكر الدولة وشهر رقم التضخم وإشارة النتيجة.
import json
import os
import urllib.request
from decimal import Decimal
def get(path):
req = urllib.request.Request(
"https://api.narwhalapi.com" + path,
headers={"Authorization": "Bearer " + os.environ["NARWHAL_API_KEY"]},
)
with urllib.request.urlopen(req, timeout=30) as r:
return json.load(r)
def check_raise(country, raise_percent):
latest = get(f"/v1/economics/{country}/inflation")
period = latest["period"]
year, month = period.split("-")
prior = f"{int(year) - 1}-{month}"
index = get(f"/v1/economics/{country}/cpi/observations?start={prior}&end={period}")
values = {o["period"]: Decimal(o["value"]) for o in index["observations"]}
from_index = (values[period] / values[prior] - 1) * 100
inflation = Decimal(latest["year_over_year"])
raise_ = Decimal(raise_percent)
real = ((1 + raise_ / 100) / (1 + inflation / 100) - 1) * 100
print(f"{country} {period}: inflation {inflation}% (from index {from_index:.2f}%), "
f"raise {raise_}%, real change {real:+.2f}%")
check_raise("DEU", "3.0")
check_raise("JPN", "2.5")
| الدولة | الشهر | التضخم | الزيادة | التغيّر الحقيقي |
|---|---|---|---|---|
| ألمانيا (DEU) | 2026-09 | 3.3% | 3.0% | -0.29% |
| اليابان (JPN) | 2026-09 | 2.1% | 2.5% | +0.39% |
زيادة ألمانيا البالغة 3.0 في المئة أقل من التضخم البالغ 3.3 في المئة، فخسر الراتب 0.29 في المئة من قوته الشرائية. أما زيادة اليابان البالغة 2.5 في المئة فتفوق 2.1 في المئة، فكسب 0.39 في المئة. ويطبع السكربت أيضًا المعدل المُعاد بناؤه من المؤشر بجانب المعدل المنشور.
رقم التضخم هو مؤشر أسعار المستهلك العام للبلد كله. يقيس سلة متوسطة، فلن يطابق تغيّر الأسعار الذي تشعر به أسرة بعينها، وهو يغطي الأسعار فقط. الزيادة التي تساوي التضخم تُبقي القوة الشرائية ثابتة في المتوسط، لكنها لا تقول هل كان الراتب كافيًا من الأصل.
ماذا يضيف التغيّر الشهري والتغيّر منذ بداية العام؟
يُظهر month_over_month تغيّر آخر شهر وحده، وهو مفيد حين تتحرك الأسعار بسرعة. وyear_to_date هو التغيّر منذ ديسمبر السابق. وهو لألمانيا 3.2، ويطابق مقارنة 126.6 بمؤشر ديسمبر 2025 البالغ 122.7. استخدمه حين تجري مراجعة الرواتب مرة كل عام في يناير وتريد معرفة ما حدث فعلًا من ارتفاع أسعار هذا العام.
لماذا نقسم بدل أن نطرح؟
يتراكم كل من الأجر والأسعار تراكمًا مركّبًا، ولذلك فإن التغيّر الحقيقي الدقيق هو النسبة. في ألمانيا يعطي طرح 3.3 من 3.0 قيمة -0.30 نقطة مئوية، بينما تعطي النسبة -0.29 في المئة. الفارق صغير عند هذه المعدلات ويكبر كلما ارتفعت.
أي فترة تضخم يجب أن أقارن بها؟
استخدم الأشهر الـ 12 التي تنتهي عند سريان الزيادة. تعيد نقطة التضخم أحدث شهر. ولشهر أقدم، استدعِ /v1/economics/{country}/inflation/observations مع start وend؛ فهي تعيد year_over_year وmonth_over_month وyear_to_date لكل period. فالزيادة السارية في يوليو 2026 مثلًا تُقارن بصف يوليو 2026.
من أين تأتي بيانات جانب الأجور؟
منك أنت. استخدم سجلات الرواتب أو خطاب العرض أو استطلاعًا تثق به، وأدخل الزيادة كنسبة مئوية. لا تملك الواجهة إلا جانب الأسعار. وبالنسبة لكندا، يمكن لمسار any-series البحث في جداول الأجور، وهو موصوف في وثائق any-series، ولا تستخدمه هذه الصفحة.
هل تصلح المقارنة بين الدول؟
تُقارن كل زيادة بأسعار بلدها وبعملته هو، ولذلك يمكن وضع التغيّرات الحقيقية جنبًا إلى جنب. لا تقول المقارنة شيئًا عن مستوى الأجور في أي من البلدين، ولا تحوّل العملات. ولترتيب الدول بحسب التضخم، يعرض دليل مقارنة التضخم بين الدول نمط الطلب.
نُشر في .