나라별 물가상승률을 순위로 비교하기

API 사용 방법

비교할 국가마다 GET /v1/economics/{country}/inflation을 사용합니다. 각 응답에는 period, year_over_year, month_over_month, year_to_date, released_on이 들어 있습니다. 비교표를 만들 때는 기준 기간과 발표일을 수치 옆에 남기세요.

스크립트는 정렬하기 전에 year_over_year를 숫자로 변환합니다. 국가 코드, 기준 기간, 발표일을 같은 행에 유지하고 인플레이션율을 소수점 첫째 자리까지 출력합니다. 반환되는 month_over_month와 year_to_date도 응답에 있지만, 이 비교에서는 일관되게 year_over_year를 사용합니다.

1. 키 발급받고 저장하기 무료 API 키를 발급받아 NARWHAL_API_KEY 환경 변수에 저장하세요. 요청은 기본 URL https://api.narwhalapi.com에 Authorization: Bearer YOUR_KEY를 사용합니다. 스크립트는 이 변수에서 키를 읽어 인증 헤더로 보냅니다.
2. 국가별로 요청하고 인플레이션율 정렬하기 Python 스크립트로 미국, 영국, 독일, 캐나다, 일본, 호주의 인플레이션율을 요청합니다. 국가마다 한 번씩 요청하고, 성공한 각 응답에서 전년 동기 대비 수치를 가져와 기준 기간과 발표일을 함께 높은 순서대로 출력합니다.
   Python으로 구하는 6개국 최신 인플레이션율

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   rows = []
   for country in ["USA", "GBR", "DEU", "CAN", "JPN", "AUS"]:
       r = requests.get(
           f"https://api.narwhalapi.com/v1/economics/{country}/inflation",
           headers=H,
           timeout=10,
       )
       if r.ok:
           d = r.json()
           rows.append(
               (float(d["year_over_year"]), country, d["period"], d["released_on"])
           )
   
   for yoy, country, period, released in sorted(rows, reverse=True):
       print(f"{country}  {yoy:>4.1f}%  {period}  released {released}")

3. 각 인플레이션율 옆의 날짜 읽기 period는 해당 인플레이션율이 가리키는 달을, released_on은 발표일을 나타냅니다. 기간이 다를 때는 독자가 어떤 달끼리 비교하는지 알 수 있도록 그 차이를 대시보드나 보고서에 포함하세요. 행을 정렬할 때도 두 날짜는 국가에 붙여 두세요.
4. 정렬된 출력을 보고서에 활용하기 출력된 각 줄은 국가 코드, 전년 동기 대비 인플레이션율, 기준 기간, 발표일 순서로 읽습니다. 대시보드나 보고서의 순위에는 이 순서를 사용하고, 비교를 갱신할 때는 발표가 있을 때마다 스크립트를 실행하세요. 출력에서 행을 복사할 때는 퍼센트 옆에 항상 기준 기간을 함께 적으세요.

스프레드시트 또는 코드 없이 계산

공표된 인플레이션율을 한눈에 보려면 웹사이트의 국가별 인플레이션 표를 사용하거나 각 국가의 인플레이션 페이지를 여세요. 국가를 직접 배열하고 싶다면 값을 시트에 붙여 넣으세요. 국가 열, 전년 동기 대비 인플레이션율, 기준 기간, 발표일을 포함해 인플레이션율이 높은 순서대로 정렬합니다.

정렬할 때는 행 전체를 함께 옮겨 인플레이션율이 국가와 날짜에서 떨어지지 않게 하세요. 시트에서는 순위를 읽는 동안 발표된 기준 기간도 계속 보이게 둘 수 있습니다. 보고서에서 같은 달끼리 비교한다면 스프레드를 계산하기 전에 기준 기간 열로 그 달에 속하는 행을 구분하세요. 기간이 다른 국가를 같은 비교에 넣을 때는 그 차이를 분명히 표시하세요.

상황별 계산 방법

국가마다 인플레이션 기준 기간이 다른 이유는 무엇인가요?

국가마다 자체 일정에 따라 발표하므로, 특정 날짜에 확인 가능한 발표가 서로 다른 달을 나타낼 수 있습니다. 2026년 10월 24일 기준 호주는 9월 수치가 아직 발표되지 않아 확인 가능한 월별 인플레이션율이 2026년 8월분이었습니다. 계산 예시의 나머지 국가는 2026년 9월분 수치가 있었습니다.

따라서 이러한 발표를 가로지르는 순위에는 기간 차이가 포함됩니다. 이 예시에서 9월끼리 비교하려면 스프레드 계산에 미국과 일본의 수치를 사용하세요. 더 넓은 순위에 호주를 포함한다면 8월이라는 레이블을 눈에 띄게 남겨 두세요.

모든 국가의 CPI는 같은 방식으로 측정되나요?

아니요. Narwhal은 각국의 공식 통계를 제공하며, 각국의 CPI는 해당 국가 통계 기관의 자체 지표입니다. 정의는 국가마다 다릅니다. 인플레이션율은 발표된 그대로 비교하고, 그 바탕이 되는 지표에 대한 자세한 내용은 경제 데이터 방법론을 읽어 보세요.

엔드포인트의 필드 이름이 같아서 응답들을 하나의 비교에 넣을 수 있습니다. 순위를 해석할 때는 각국의 지표가 그 나라 고유의 것임을 염두에 두세요. 응답 필드가 같다고 해서 국가별 CPI 정의가 같아지는 것은 아닙니다.

어떤 국가의 인플레이션 요청이 404를 반환하면 어떻게 하나요?

404 series_not_found 응답은 해당 인플레이션 시계열이 지원되지 않거나 아직 발표되지 않았다는 뜻입니다. 2026년 10월 24일 기준 인도네시아와 한국의 인플레이션 요청이 이 오류를 반환했습니다. 지원 국가 목록은 커버리지 페이지를 확인하세요.

그 국가를 건너뛰고 보고서에 제외했음을 명시하세요. 제외한 국가는 비교에 쓸 인플레이션율이 없으므로 순위와 스프레드 계산에서 빼세요. 스크립트의 성공한 행만으로는 누락 이유를 알 수 없으므로, 오류 응답을 사용해 해당 국가가 빠진 이유를 설명하세요.

계산 예시: 6개국 순위

2026년 10월 24일 기준으로 확인 가능한 발표에서 시작합니다. 각 국가의 전년 동기 대비 인플레이션율을 가져와 높은 순서대로 행을 정렬합니다. 각 값 옆에 기준 기간과 발표일을 남기세요.

2026년 10월 24일 기준 확인 가능한 발표에서 이 그룹의 가장 높은 인플레이션율은 2026년 8월분 호주의 4.0%였고, 가장 낮은 것은 2026년 9월분 일본의 2.1%였습니다. 이 두 값을 전체 순위의 스프레드에 사용하세요. 2026년 9월이라는 공통 기간에서는 미국의 3.7%를 일본의 2.1%와 짝지으세요.

2026년 10월 24일 기준 확인 가능한 모든 발표에 걸친 스프레드는 호주의 2026년 8월 인플레이션율에서 일본의 2026년 9월 인플레이션율을 빼서 구합니다. 그런 다음 미국과 일본의 2026년 9월 인플레이션율로 미국과 일본의 스프레드를 계산하세요. 각 차이는 퍼센트포인트로 나타내고 계산에 기준 기간 레이블을 남기세요.

Australia (August 2026) to Japan (September 2026):
4.0% - 2.1% = 1.9 percentage points

United States (September 2026) to Japan (September 2026):
3.7% - 2.1% = 1.6 percentage points