Narwhal API
繁體中文
所有 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
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_cpi

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

獲取某一個月的同比、環比和年初至今通脹率。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_inflation

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

獲取 該 官方 失業率 匯率 用於 一個 觀測值 期間.

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_unemployment

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

獲取 該 官方 勞動力參與率 匯率 用於 一個 觀測值 期間.

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_labour_force_participation

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

獲取一個季度的現價國家 GDP。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_gdp

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

獲取一個季度的官方實際 GDP 增長指標。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_gdp_growth

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

獲取一個期間的出口、進口和確切商品貿易餘額。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_trade

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

獲取一個國家某個期間的商品出口總額。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。
partner
根據合約已接受，但當前測試版不會發布篩選後的合作夥伴總數。
product
HS 商品代碼。請將其與分類一並提供。
classification
《協調制度》的版本。請與product一同提供。

MCP · economics_get_trade_exports

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

獲取一個國家某個期間的商品進口總額。

country
支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。
partner
根據合約已接受，但當前測試版不會發布篩選後的合作夥伴總數。
product
HS 商品代碼。請將其與分類一並提供。
classification
《協調制度》的版本。請與product一同提供。

MCP · economics_get_trade_imports

API 參考 →歷史 →

來源與方法論

明確的期間

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

REST 和 MCP

REST 與 MCP 共享18個操作、架構和配額。

覆蓋範圍

查看覆蓋範圍 →

查看來自十個國家官方發布機構的當前和歷史經濟數據。

AUS CAN DEU FRA GBR JPN MYS NLD SGP USA

常見問題

支援哪些國家？

澳大利亞、加拿大、德國、法國、英國、日本、馬來西亞、荷蘭、新加坡和美國。

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

是。九個最新發布操作中的每一個，都有一個對應的observations路由，用於當前已接受的歷史序列。

經濟數據來自哪裡？

每個已上線數據流都來自覆蓋矩陣中列出的政府統計機構或其他官方國家發布機構。

新發布數據多久可以獲取？

Narwhal 會在發布通過驗證後發布。公開測試版不承諾固定的來源到發布延遲。

發起你的第一個請求

獲取免費 API 密鑰 →