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

不要將金鑰放在 URL 中

將 Narwhal 金鑰儲存為機密資料或環境變數，並在 Authorization 標頭中以 Bearer 權杖傳送。不要將金鑰放入查詢字串、提交至程式碼儲存庫，或暴露在瀏覽器端的程式碼中。

呼叫 CPI 端點

省略期間，以取得最新已接受的完整發布版本。

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 替換為涵蓋範圍矩陣中該操作列出的國家代碼，再將 cpi 替換為文件所載的通膨、失業率、勞動參與率、GDP、GDP 成長率、貿易、出口或進口操作路徑。這些操作的涵蓋範圍可能不同。

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

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

錯誤回應本文使用 application/problem+json，並包含請求 ID。收到 500 和 503 回應時，請採用設有上限的退避策略重試。收到 400 和 401 回應時，請先修正問題再重試；收到 429 回應時，請等到文件所載的重設時間再重試。

REST 和 MCP 使用相同的資料

MCP 工具使用與 REST 相同的金鑰、已儲存的發布版本、回應結構及資料配額。請選擇適合你應用程式的介面；底層經濟數據相同。

請求有範圍限制的歷史資料分頁

需要最新發布版本以外的資料時，請使用對應的歷史資料路由。分頁時保持 country、start、end 和 limit 不變，並將回傳的 next_cursor 作為下一次請求的 cursor。若游標過期或發布版本被撤回，請移除游標後重新開始。有效範圍內沒有資料，與序列無法使用是不同情況；應用程式應保留其空結果。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-01&end=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"