了解指數及其編製方式
消費者物價指數(CPI)追蹤家庭購買一籃子商品與服務所支付價格的變化。統計機關蒐集價格,並按支出權重加以彙整。占家庭支出比重越大的項目,對總指數的影響越大。統計機關也會處理產品品質的變化,並隨支出模式改變更新籃子。
指數有參考基期與基值,基值通常為 100。指數水準描述相對於該基準的價格變化。它不是貨幣金額,也不是在另一國家購買同一籃子商品與服務的成本。個別家庭的支出結構也可能與全國數據所依據的籃子不同。
通膨率比較兩個時點的指數水準。一般計算公式為(後期指數 / 前期指數 - 1)× 100。務必說明使用哪個前期作為基準。年增率、月增率與年初至今的變動率,回答的是同一價格序列的不同問題。
透過範例計算
此處計算中的所有數字均為示例。假設指數在上年 7 月為 200,12 月為 204,當年 6 月為 208,7 月為 210。每個觀測值都使用相同的籃子序列、基期與調整方式。
年增通膨率為 (210 / 200 - 1) × 100 = 5%。月增通膨率為 (210 / 208 - 1) × 100,即約 0.96%。年初至今通膨率為 (210 / 204 - 1) × 100,即約 2.94%。Narwhal 將年初至今的比較基準定義為上年 12 月。
月度上升了 2 個指數點,但不是 2%。分母很重要。如果之後通膨放緩但仍為正值,指數仍會上升。物價只是漲得更慢,並未回到先前水準。負變動率則表示指定期間內物價下降。
比較國家前先核對基準
各國的支出權重、人口涵蓋範圍與住房處理方式不同,基期也可能不同。一國的指數水準較高,並不代表該國物價比另一國更貴。即使將兩個序列的起始值重設為相同水準,也只能比較之後的價格變化。
對齊觀測月份與變動區間。年平均通膨指標比較不同年份的平均值。某個月的年增率則比較該月與上年同月。兩者不能互換。作為比較基準的上年月份若有較大波動,也會影響年增率。
比較月度變化前先核對季節調整。季節調整會去除反覆出現的季節性模式,調整後與未調整序列的月度結果可能不同。自行計算變動率時,應維持相同的基準與調整方式。不要把月度百分比變化相加得到年度變動率,因為變化是複合累積的。
向 Narwhal 請求 CPI 與通膨率
使用 /v1/economics/{country}/cpi 取得總指數,使用 /v1/economics/{country}/inflation 取得百分比變化。兩項操作都使用 YYYY-MM 格式的月度期間。這些請求選擇 USA 與同一個示例觀測月份,方便合併查看兩個輸出。
透過 Authorization 標頭傳送 API 金鑰,並將其保存在伺服器端環境變數中。通膨回應為每個比較區間命名,因此圖表或表格可使用與標籤相符的欄位。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/inflation?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"解讀指數回應
此 CPI 回應範例在 value 中顯示指數水準,在 base_period 與 base_value 中顯示其基準。數值是十進位數字字串,代表指數水準,因此不要附加百分比符號。period 表示觀測月份,released_on 表示發布日期。
獨立的通膨回應使用 year_over_year、month_over_month 與 year_to_date,並將 unit 設為 percent。其 7 月示例值依序為 3.651%、0.153% 與 0.755%。這些 API 範例與上面的簡化計算各自獨立。顯示三個變動率中的任何一個時,都應同時顯示比較區間。
{
"country": "USA",
"period": "2026-07",
"value": "333.918",
"base_period": "1982-84",
"base_value": "100",
"released_on": "2026-08-12"
}查看通膨率與 CPI 資料頁面
開啟下方的「各國通膨率」與「各國 CPI」,選擇應用程式所需的指標。查看美國資料時,請使用「美國通膨率」頁面。比較變動率時結合其區間,比較指數時結合其基期,再透過經濟數據 API 參考了解請求詳情。
《失業率與勞動力參與率解析》介紹另一種常見差異:主要比率與其背後的人口或總量有何不同。
來源與參考
發布日期: 。最近審閱日期: 。

