比較各國通膨

使用 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：六國最新通膨率

   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 日，印尼與南韓的通膨率回傳了這個錯誤。已涵蓋國家的清單請查看涵蓋範圍頁面。

略過該國，並在報告中說明遺漏。被遺漏的國家在比較中沒有通膨率，因此請把它從排名與利差計算中去掉。僅憑腳本成功的列無法解釋某個國家為何缺席；請用錯誤回應來說明它缺少的原因。

計算範例：六國排名

從 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