各国のインフレ率を比較する

APIを使う方法

比較したい国ごとにGET /v1/economics/{country}/inflationを使います。各レスポンスにはperiod、year_over_year、month_over_month、year_to_date、released_onが含まれます。比較表を作るときは、対象期間と発表日を数値の横に残してください。

スクリプトは並べ替えの前にyear_over_yearを数値に変換します。国コード、対象期間、発表日を同じ行に保持し、インフレ率を小数点以下1桁で出力します。返されるmonth_over_monthとyear_to_dateはレスポンスで利用できますが、この比較では一貫してyear_over_yearを使います。

1. キーを取得して保存する 無料のAPIキーを取得し、環境変数NARWHAL_API_KEYに保存します。リクエストはベースURLhttps://api.narwhalapi.comに対してAuthorization: Bearer YOUR_KEYを使います。スクリプトはこの変数からキーを読み取り、認可ヘッダーで送信します。
2. 各国をリクエストして利率を並べ替える Pythonスクリプトで、米国、英国、ドイツ、カナダ、日本、オーストラリアのインフレ率を取得します。国ごとに1回リクエストし、成功した各レスポンスから前年比の値を取り出して、高い順に対象期間と発表日とともに出力します。
   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は公表日を示します。期間が異なる場合は、読み手がどの月同士を比べているのか分かるよう、その違いをダッシュボードやレポートに含めてください。並べ替えるときも、2つの日付は国に付けたままにします。
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%でした。この2つを、順位全体のスプレッドに使います。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