Narwhal 文件
繁體中文
API 參考網站
瀏覽全部文件

Economics API 參考

十個國家的最新發布和歷史觀測數據。

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

基礎 URL 和參數

REST 基礎路徑
https://api.narwhalapi.com/v1/economics/{country}
  • country 是受支援的大寫 ISO alpha-3 代碼。
  • period 為可選項。對於最新發布版本請省略；否則傳入該操作要求的月、季度或年份格式。
  • 每個請求都必須攜帶文件所述的 Bearer 請求頭： 身份驗證.
請求一個已知期間
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

國家

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP，以及 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 與發現功能

當前公開測試限制

公開發現僅限於上述 18 條路由和十個國家。印度尼西亞及地區路由不屬於公開 Economics 測試版。

查看 錯誤與配額 用於說明序列缺失和服務不可用時的行為。