區分產出價值與成長
國內生產毛額(GDP)衡量一個經濟體在一定期間內生產的最終商品與服務的價值,避免將中間投入重複計為最終產出。統計機關結合企業調查、行政紀錄與其他來源資料,估算生產、支出與所得。
當期價格的 GDP 使用所衡量期間的價格計算產出價值。它可能因產量增加、價格上漲,或兩者同時發生而上升。實質 GDP 調整了價格變化,以衡量產出數量的變化。實質 GDP 成長率是這項調整後指標的百分比變化。
一種支出法將消費、投資、政府購買商品與服務的支出,以及出口相加,再減去進口。減去進口是因為進口產品可能已計入各類支出。這項核算步驟使總量僅反映國內生產。
Narwhal 的 GDP 端點以本國貨幣回傳當期價格水準。GDP 成長率端點回傳實質成長指標。建立計算或圖表標籤時,應區分這些價格基礎。
計算季度與年化成長
本例中的所有數字均為示例。假設實質 GDP 指數從第一季的 100 升至第二季的 101。季增率為 (101 / 100 - 1) × 100 = 1%。若上年同季的指數為 98,則年增率約為 3.06%。
季度年化增速表示:如果一季的速度連續重複四季,會產生怎樣的變化。計算公式為 ((1 + 季成長率 / 100)^4 - 1) × 100。以示例中的季度成長 1% 計算,年化增速約為 4.06%。它不是預測,也不是已經記錄到的全年變化。
全年成長率比較年度實質 GDP 指標,不一定等於最後一季的年增率。另外,年化 GDP 水準是將一季的產出按全年速度表示。不要將該水準解讀為該季本身的產出金額。
對齊比較基準,並考慮修訂
比較國家前,先對齊價格基礎、期間、季節調整與年化方式。經季節調整的季度增速,不能與未調整的年增率直接比較。各國貨幣不同,也代表若沒有明確的換算方法,就不能直接比較以貨幣計量的 GDP 水準。
實質成長率避免了直接比較貨幣金額水準,但仍需對齊區間與計算慣例。較大的經濟體可能比較小的經濟體成長更慢。GDP 水準的大小與其變化速度描述的是不同的事物。
初步 GDP 估計使用的資訊並不完整。統計機關在取得調查、行政紀錄與其他資料後,會修訂估計值。後續方法更新也可能改變歷史估計。在報告中使用任何數值時,應記錄其發布日期,讓讀者知道計算依據的是哪次發布。
請求水準與成長率
使用 /v1/economics/{country}/gdp 取得季度當期價格 GDP,使用 /v1/economics/{country}/gdp-growth 取得季度實質成長率。兩者都使用 YYYY-QN 格式的期間。這些請求選擇同一個美國示例季度。
透過 Authorization 標頭傳送 API 金鑰。實質成長應使用已發布的成長率欄位;計算兩個當期價格 GDP 值之間的百分比變化,得到的則是名目變化。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/gdp?period=2026-Q2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
--header "Authorization: Bearer $NARWHAL_API_KEY"解讀成長率回應的中繼資料
在此回應範例中,price_basis 為 constant,annualization 為 not_annualized。因此,quarter_over_quarter 的 0.503% 表示季度變化。year_over_year 的 2.4% 則以上年同季為比較基準。不得將任何一個值改標為另一個指標。
GDP 水準回應包含 value、currency、price_basis、seasonal_adjustment 與 annualization。所提供的範例使用當期價格、USD 與年化水準。應分別讀取每個回應的中繼資料,不要假設水準與成長率採用相同的年化慣例。
成長率值是以百分比為單位的十進位數字字串。選用欄位 year_to_date 僅在官方來源發布時出現。本例中沒有該欄位。應保留其缺漏狀態,不要將其視為零。
{
"country": "USA",
"period": "2026-Q2",
"year_over_year": "2.4",
"quarter_over_quarter": "0.503",
"unit": "percent",
"price_basis": "constant",
"seasonal_adjustment": "seasonally_adjusted",
"annualization": "not_annualized",
"released_on": "2026-07-30"
}查看 GDP 資料頁面
開啟下方的「各國 GDP」與「各國 GDP 成長率」,在貨幣金額水準與實質成長指標之間選擇。查看美國資料時,請使用「美國 GDP 成長率」頁面。在顯示的數字旁保留回應中的價格基礎與年化方式。
經濟數據 API 參考涵蓋請求詳情。《CPI 是什麼:與通膨率的差異及計算方式》介紹指數水準與百分比變化,包括比較期間為何重要。
來源與參考
發布日期: 。最近審閱日期: 。

