發起你的第一個經濟數據請求

不要將密鑰放在 URL 中

將 Narwhal 密鑰儲存為密鑰或環境變量。在 Authorization 標頭中以 Bearer 令牌發送。不要將其放進查詢字串、提交到代碼庫或暴露在瀏覽器代碼中。

呼叫 CPI 端點

省略 period 以獲取最新已接受的完整發布版本。

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

閱讀回應

回應是帶類型的JSON，不含通用data包裝器。十進位數值使用字串，避免客戶端無提示地丟失精度。缺失值保持缺失，不會變為零。

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

更改國家或操作

將 USA 替換為 AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD 或 SGP，即可為另一個已上線國家請求相同指標。將 cpi 替換為其他文件化操作路徑，即可請求通脹、失業、勞動力參與率、GDP、GDP 增長、貿易、出口或進口數據。

按狀態和錯誤代碼處理錯誤

400 回應表示請求無效；401 表示 API 密鑰缺失或無效；404 表示所請求的路由或序列不可用；429 表示額度已耗盡；503 表示當前無法安全提供所請求的數據或服務。

錯誤正文使用 application/problem+json，並包含請求 ID。對 500 和 503 回應使用有界退避重試。再次嘗試前修正 400 和 401 回應；重試 429 前等待文件說明的重置時間。

REST 和 MCP 使用 該 相同 數據

MCP 工具使用與 REST 相同的密鑰、已儲存發布版本、回應架構和數據額度。選擇適合應用的介面；底層經濟數據相同。