昇給が物価に追いつくのは、昇給率が CPI の前年比以上のときです。Narwhal は国ごとのインフレ率を提供し、以下の Python が昇給率とインフレ率から実質的な変化を求めます。ほとんどの国の賃金ベンチマークデータは持っていません。
各国のインフレ率を読む
インフレ率エンドポイントは、ある国の最新の年次と月次の物価変動を返します。この 2 つのリクエストは、ドイツと日本を求めています。
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 は、消費者物価指数の 1 年前の同じ月に対する変化率(%)で、最新の月 period ではドイツが 3.3、日本が 2.1 です。month_over_month は前の月からの変化、year_to_date は 12 月からの変化です。released_on は公表日です。値はパーセントの 10 進数の文字列です。
指数と照らし合わせて確認する
同じ率は指数から再現できます。observations エンドポイントは月次の CPI を返し、以下のレスポンスは、ドイツで返された 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 なので、指数は 12 か月で 3.26 パーセント上昇しており、これを丸めると year_over_year の 3.3 になります。日本について同じ確認をすると、102.2 と 100.1 から 2.10 パーセントになります。
昇給を物価と比べる
Narwhal は、ほとんどの国の給与や賃金のベンチマークデータを持っていないため、このページが書くのは物価の側だけです。昇給率は自分で用意します。実質的な変化は、1 に昇給率を足した値を 1 にインフレ率を足した値で割り、1 を引いたものです。結果がプラスなら、給与は 1 年前より多くのものを買えます。マイナスなら、買える量が減っています。
- 昇給率を用意する 2 つの時点の給与の変化率を使います。どちらも、月額の総支給額など同じ基準で比べます。
- インフレ率を読む その国のインフレ率を取得し、
periodとyear_over_yearを残します。 - 比率を計算する 1 に昇給率を足した値を 1 にインフレ率を足した値で割り、1 を引いて 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 パーセント増えました。スクリプトは、公表値の隣に、指数から再計算した率も出力します。
インフレ率は国全体の総合 CPI です。平均的なバスケットを測るため、1 世帯が実感する物価の変化とは一致せず、対象は物価だけです。インフレ率に並ぶ昇給は、平均すると購買力を同じに保ちますが、そもそもその給与が十分だったかどうかは何も示しません。
前月比と年初来は何を教えてくれますか?
month_over_month は最新の 1 か月だけの変化を示し、物価が急に動いているときに役立ちます。year_to_date は前年の 12 月からの変化です。ドイツでは 3.2 で、126.6 を2025年12月の指数 122.7 と比べた値に一致します。給与の見直しが毎年 1 月に 1 回あり、その年の物価上昇のうちどれだけがすでに起きたかを知りたいときに使ってください。
なぜ引き算ではなく割り算をするのですか?
給与も物価も複利で動くため、正確な実質的な変化は比率です。ドイツでは 3.3 から 3.0 を引くと -0.30 パーセントポイントですが、比率では -0.29 パーセントです。この程度の率では差は小さく、率が高くなるほど広がります。
どのインフレ率の期間と比べればよいですか?
昇給が有効になった時点で終わる 12 か月を使います。インフレ率エンドポイントは最新の月を返します。それより前の月は、start と end を付けて /v1/economics/{country}/inflation/observations を呼ぶと、各 period の year_over_year、month_over_month、year_to_date が返ります。たとえば2026年7月に有効になった昇給は、2026年7月の行と比べます。
給与の側のデータはどこから得られますか?
あなた自身からです。給与明細、オファーレター、信頼できる調査を使い、昇給率をパーセントで入力します。API にあるのは物価の側だけです。カナダでは、any-series ルートで賃金に関する表を検索できます。これは any-series のドキュメントに説明がありますが、このページでは使っていません。
国をまたいで比較できますか?
それぞれの昇給は、その国自身の物価と、その国の通貨で比べるため、実質的な変化を並べて見ることができます。この比較は、どちらの国の給与水準についても何も言えず、通貨の換算もしません。国同士のインフレ率のランキングが必要なら、国別のインフレ率を比較するガイドにリクエストの進め方があります。
公開。