文件
API 參考網站
瀏覽全部文件

經濟數據 API 參考

最新發布資料與歷史觀測資料，涵蓋範圍依國家與指標列出。

九條路由回傳最近一次接受的官方發布資料。九條對應的 /observations 路由回傳當前已接受的時間序列。REST 和 MCP 使用相同的架構，並消耗相同的月度配額。

基礎 URL 和參數

REST 基礎路徑
https://api.narwhalapi.com/v1/economics/{country}
  • country 是受支援的大寫 ISO alpha-3 代碼。
  • period 為可選項。對於最新發布版本請省略；否則傳入該操作要求的月、季度或年份格式。
  • /v1/economics/{country}/cpi 等核心經濟數據端點及其 MCP 工具可能回傳主要指標首次發布的暫估值，回應不會註明其為暫估值；來源發布最終數值後，Narwhal API 會替換這些值。
  • 每個請求都必須包含 Bearer 標頭，詳見 身分驗證。
請求一個已知期間
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

國家

36 國家

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

涵蓋範圍依操作與國家而異。各項操作均列出其支援的國家。

最新發布版本

開啟各項操作的頁面，查看確切參數、接受的期間格式、回應欄位、範例、錯誤、資料時效及目前限制。

操作REST 路徑期間
消費者物價指數/v1/economics/{country}/cpiYYYY-MM
通膨/v1/economics/{country}/inflationYYYY-MM
失業率/v1/economics/{country}/unemploymentYYYY, YYYY-MM, or YYYY-QN
勞動力參與率/v1/economics/{country}/labour-force-participationYYYY, YYYY-MM, or YYYY-QN
國內生產毛額/v1/economics/{country}/gdpYYYY-QN
GDP 成長率/v1/economics/{country}/gdp-growthYYYY-QN
商品貿易/v1/economics/{country}/tradeYYYY or YYYY-MM
貨物出口/v1/economics/{country}/trade/exportsYYYY or YYYY-MM
貨物進口/v1/economics/{country}/trade/importsYYYY or YYYY-MM

歷史觀測資料

歷史路由接受 start, end, limit，以及 cursor。結果按時間由舊到新排列，代表目前已接受的資料序列，而非過去每次發布時的資料版本。

操作REST 路徑期間
消費者物價指數歷史資料/v1/economics/{country}/cpi/observationsYYYY-MM
通膨歷史資料/v1/economics/{country}/inflation/observationsYYYY-MM
失業率歷史資料/v1/economics/{country}/unemployment/observationsYYYY, YYYY-MM, or YYYY-QN
勞動力參與率歷史資料/v1/economics/{country}/labour-force-participation/observationsYYYY, YYYY-MM, or YYYY-QN
國內生產毛額歷史資料/v1/economics/{country}/gdp/observationsYYYY-QN
GDP 成長率歷史資料/v1/economics/{country}/gdp-growth/observationsYYYY-QN
貨物貿易歷史資料/v1/economics/{country}/trade/observationsYYYY-MM
貨物出口歷史資料/v1/economics/{country}/trade/exports/observationsYYYY-MM
貨物進口歷史資料/v1/economics/{country}/trade/imports/observationsYYYY-MM

欄位約定

欄位或規則含義
country請求的ISO alpha-3國家代碼。
period回應所代表的確切官方月份、季度或年份。
released_on官方發布日期，而不是 Narwhal 的檢索時間。
十進位字串經濟數值使用字串，以保留精確的十進位表示。
單位和基準比率、貨幣、價格基準、年化方式、涵蓋範圍和指數基期在適用時都會明確標示。
缺失的發布版本Narwhal 會拒絕提供資料，不會編造、沿用前值或將缺失值轉換為零。

OpenAPI 與探索功能

目前公開測試版的限制

公共探索僅限於上述國家路由。印尼與區域路由不屬於公共經濟學測試版。

查看 錯誤與配額 以了解序列缺失與服務無法使用時的處理方式。