연봉 인상이 물가를 따라가려면 인상률이 CPI 전년 대비 변화율 이상이어야 합니다. 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는 소비자물가지수가 1년 전 같은 달에 비해 변한 비율(%)로, 최신 월인 period에서 독일은 3.3, 일본은 2.1입니다. month_over_month는 직전 달 이후의 변화, year_to_date는 12월 이후의 변화입니다. released_on은 발표일입니다. 값은 퍼센트 단위의 십진수 문자열입니다.
지수와 대조해 확인하기
같은 비율은 지수에서 다시 계산할 수 있습니다. 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년 전보다 더 많이 살 수 있고, 마이너스이면 더 적게 살 수 있습니다.
- 인상률 준비하기 두 시점 사이 급여의 변화율을 사용합니다. 두 시점 모두 월 총급여처럼 같은 기준으로 비교해야 합니다.
- 물가 상승률 읽기 해당 국가의 물가 상승률을 요청하고
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입니다. 평균적인 소비 바구니를 측정하므로 한 가구가 체감하는 물가 변화와는 일치하지 않으며, 다루는 것은 물가뿐입니다. 물가 상승률과 같은 인상은 평균적으로 구매력을 그대로 유지하지만, 애초에 그 급여가 충분했는지는 알려 주지 않습니다.
전월 대비와 연초 대비는 무엇을 알려 주나요?
month_over_month는 최근 한 달만의 변화를 보여 주며 물가가 빠르게 움직일 때 유용합니다. year_to_date는 전년 12월 이후의 변화입니다. 독일은 3.2이며, 126.6을 2025년 12월 지수 122.7과 비교한 값과 일치합니다. 급여 조정이 매년 1월에 한 번 있고, 그해 물가 상승분 중 얼마나 이미 일어났는지 알고 싶을 때 사용하세요.
왜 빼지 않고 나누나요?
급여와 물가는 모두 복리로 움직이므로 정확한 실질 변화는 비율입니다. 독일에서 3.0에서 3.3을 빼면 -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 문서에 설명되어 있지만 이 페이지에서는 사용하지 않습니다.
국가 간 비교도 가능한가요?
각 인상률은 그 나라 자체의 물가와 그 나라 통화로 비교하므로 실질 변화를 나란히 놓고 볼 수 있습니다. 이 비교는 어느 나라의 급여 수준에 대해서도 말해 주지 않으며, 통화를 환산하지도 않습니다. 국가 간 물가 상승률 순위가 필요하다면 국가 간 물가 상승률 비교하기 가이드에 요청 방식이 나와 있습니다.
에 게시되었습니다.