所有 API

經濟數據 API

透過單一來源，取得官方統計機構發布的 CPI、通膨、勞動力、GDP 和貿易資料。

首次請求

快速入門 →

取得某個國家在指定月份的整體消費者物價指數。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例 示意回應 · 非實際請求結果
{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

端點

GET消費者物價指數/v1/economics/{country}/cpi

取得某個國家在指定月份的整體消費者物價指數。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_cpi

API 參考 →歷史 →
GET通膨/v1/economics/{country}/inflation

取得指定月份的通膨年增率、月增率及年初至今通膨率。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_inflation

API 參考 →歷史 →
GET失業率/v1/economics/{country}/unemployment

取得一個觀測期間的官方失業率。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_unemployment

API 參考 →歷史 →
GET勞動力參與率/v1/economics/{country}/labour-force-participation

取得一個觀測期間的官方勞動力參與率。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_labour_force_participation

API 參考 →歷史 →
GET國內生產毛額/v1/economics/{country}/gdp

取得某一季以當期價格計算的全國 GDP。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_gdp

API 參考 →歷史 →
GETGDP 成長率/v1/economics/{country}/gdp-growth

取得某一季的官方實質 GDP 成長指標。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_gdp_growth

API 參考 →歷史 →
GET商品貿易/v1/economics/{country}/trade

取得某一期間的出口額、進口額及精確的貨物貿易差額。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。

MCP · economics_get_trade

API 參考 →歷史 →
GET貨物出口/v1/economics/{country}/trade/exports

取得某個國家在指定期間的貨物出口總額。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
partner
API 規格接受此參數，但目前測試版尚未發布依貿易夥伴篩選的總額。
product
HS 商品代碼。請與 classification 一併提供。
classification
Harmonized System 的版本。請與 product 一併提供。

MCP · economics_get_trade_exports

API 參考 →歷史 →
GET貨物進口/v1/economics/{country}/trade/imports

取得某個國家在指定期間的貨物進口總額。

country
一個受支援的大寫國家代碼；請參閱此操作的涵蓋清單。
period
省略此參數可取得已採納的最新完整發布資料，或傳入一個確切期間。
partner
API 規格接受此參數，但目前測試版尚未發布依貿易夥伴篩選的總額。
product
HS 商品代碼。請與 classification 一併提供。
classification
Harmonized System 的版本。請與 product 一併提供。

MCP · economics_get_trade_imports

API 參考 →歷史 →

來源與方法論

明確的期間

每個回應都包含觀測期間和官方發布日期。

REST 和 MCP

REST 和 MCP 在所有可用操作中共用資料結構和配額。

涵蓋範圍

查看涵蓋範圍 →

探索各國官方發布機構提供的目前與歷史經濟數據。涵蓋範圍依操作與國家而異。

指標

物價

CPI (英文)通膨 (英文)

勞動力

失業率 (英文)勞動力參與率 (英文)

產出

GDP (英文)GDP 成長率 (英文)

貿易

貿易差額 (英文)出口 (英文)進口 (英文)

利率

殖利率曲線 (英文)

國家

澳大利亞 (英文)奧地利 (英文)比利時 (英文)加拿大 (英文)智利 (英文)哥倫比亞 (英文)捷克 (英文)德國 (英文)丹麥 (英文)西班牙 (英文)愛沙尼亞 (英文)芬蘭 (英文)法國 (英文)英國 (英文)克羅埃西亞 (英文)愛爾蘭 (英文)義大利 (英文)日本 (英文)立陶宛 (英文)盧森堡 (英文)拉脫維亞 (英文)墨西哥 (英文)馬來西亞 (英文)荷蘭 (英文)挪威 (英文)紐西蘭 (英文)巴基斯坦 (英文)菲律賓 (英文)波蘭 (英文)葡萄牙 (英文)卡達 (英文)沙烏地阿拉伯 (英文)新加坡 (英文)斯洛維尼亞 (英文)瑞典 (英文)美國 (英文)

探索相關頁面

英國與美國殖利率曲線 API

英國採用英格蘭銀行名目零息殖利率，美國採用美國財政部名目平價殖利率。可透過 REST 和 MCP 取得單一來源日期或分頁歷史資料。

探索 API → (英文)

常見問題

支援哪些國家？

查閱涵蓋範圍表，確認已發布資料涵蓋哪些國家。可用指標與歷史期間依國家而異。

API 是否包含歷史經濟數據？

是。九項取得最新發布資料的操作各有對應的 observations 路由，可用來取得目前已採納的歷史序列。

經濟數據來自哪裡？

每個已上線的資料串流都來自涵蓋範圍矩陣中列出的政府統計機構或其他各國官方發布機構。

新發布的資料多久後可取得？

Narwhal 會在發布資料通過驗證後予以發布。公開測試版不保證從來源發布到 Narwhal 發布之間有固定的時間差。

送出你的第一個請求

取得免費 API 金鑰 →