按通膨調整價格

用 API 調整價格

計算公式為 adjusted = price x CPI(to month) / CPI(from month)。金額要與其原始月份對應，再選擇要換算到的月份。後一個月的指數放在分子，前一個月的指數放在分母。

1. 設定你的 API 金鑰 取得免費金鑰，並儲存在環境變數 NARWHAL_API_KEY 中。請求會把該值放在 Authorization: Bearer YOUR_KEY 標頭中傳送。
2. 選擇價格對應的月份 以美國為例，請求 GET /v1/economics/USA/cpi/observations?start=2025-11&end=2026-09。以 2025 年 11 月為原始月份，以 2026 年 9 月為要換算到的月份。
3. 讀取指數並計算金額 使用與價格幣別對應國家的 CPI。腳本按期間讀取回傳的觀測值，將 2026 年 9 月的指數除以 2025 年 11 月的指數，再把原始金額乘以該比值。
   Python：將 2025 年 11 月的 100 美元調整為 2026 年 9 月的金額

   import os
   import requests
   
   r = requests.get(
       "https://api.narwhalapi.com/v1/economics/USA/cpi/observations",
       params={"start": "2025-11", "end": "2026-09"},
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   )
   r.raise_for_status()
   cpi = {o["period"]: float(o["value"]) for o in r.json()["observations"]}
   
   
   def adjust(amount: float, from_period: str, to_period: str) -> float:
       """Express an amount from one month in the money of another month:
       amount x CPI(to) / CPI(from)."""
       return amount * cpi[to_period] / cpi[from_period]
   
   
   print(round(adjust(100, "2025-11", "2026-09"), 2))

4. 讀取所選期間的結果 腳本會輸出 103.95，即相當於 2025 年 11 月 100 美元的 2026 年 9 月美元金額。如果只需要某個月的指數，請使用 GET /v1/economics/USA/cpi?period=2025-11。

回應中的 observations 清單包含每個觀測值的 period 和 value。腳本把這些值轉換為數字，並按月份儲存。adjust 函式接收金額和月份標籤，再從該字典中讀取對應的指數。兩個月份標籤都必須出現在回傳的觀測值中。除法使用完整的 CPI 數值，並像腳本處理 2026 年 9 月的結果那樣，對最終的美元金額進行四捨五入。

請求歷史資料時，請查看回傳的第一個日期。所有帳戶都可讀取完整歷史。晚於請求日期才開始的序列會從其第一個觀測值開始，因此回應的起點可能比您要求的更晚。

在試算表或計算機中調整價格

如果只需計算有計算機頁面的國家的單一金額，請使用通膨計算機。選擇與貨幣對應的國家以及要比較的月份。金額仍屬於原始月份，結果表示它在另一個月份的購買力。

在試算表中，把較早月份的 CPI 指數放在 B1，較晚月份的 CPI 指數放在 B2。對於 100 美元，使用下面的公式。B1 填 2025 年 11 月的美國指數，B2 填 2026 年 9 月的美國指數，計算所用的比值與 Python 腳本相同。

=100*B2/B1

儲存格的順序很重要，因為公式是乘以較晚月份的指數、再除以較早月份的指數。請把月份標籤與 CPI 數值放在一起，使金額、起始月份和結束月份保持關聯。

如果有一欄帶日期的價格，請使用腳本。每次計算都需要原始金額及其月份，以及要換算到的月份。該函式可以對回傳的觀測值使用不同的金額和月份標籤；CPI 比值取決於每個價格所選的月份。

年度價格應該用哪個月？

使用價格所屬的月份；如果價格是年度資料，則使用年度平均值。整個比較過程中要保持這一選擇一致。對應 2025 年 11 月的價格使用該月的 CPI，年度資料則可以使用年度平均值。

選擇指數之前，先確定價格對應的是某個月還是某一年。這決定了哪個 CPI 數值放在計算的前一部分，哪個放在後一部分。

可以用美國的通膨調整其他貨幣的價格嗎？

使用價格所用貨幣所屬國家的 CPI。對於歐元價格，使用歐元區或你選定國家的指數。在選擇較早和較晚月份的 CPI 值時，要保持這一選擇一致。

美元範例對 2025 年 11 月和 2026 年 9 月都使用美國 CPI。對於其他貨幣的價格，在把比值套用到金額之前，先確定國家。

可以把價格調整到未來的月份嗎？

調整到未來需要你自己的假設，因為 CPI 只會公布過去月份的資料。公式需要你要換算到的那個月的指數，而未來月份的 CPI 屬於預測假設。

預測金額要始終標明對應的期間。2025 年 11 月到 2026 年 9 月的範例使用這些月份的 CPI 值，而以未來月份貨幣價值表示的金額則取決於你選擇的假設。

計算範例：2025 年 11 月 100 美元的購買

從 2025 年 11 月的價格 100 美元開始。美國 CPI 指數在 2025 年 11 月為 324.122，2026 年 9 月為 336.940。兩者的指數基期都是 1982-84=100。

從 2025 年 11 月到 2026 年 9 月，通膨調整幅度為 10 個月 3.95%。該百分比描述的是所選兩個月份之間的變化，不是年率。