消費者價格指數 (CPI) API
獲取一個國家某個月份的總體居民消費價格指數。
economics_get_cpi 可通過 REST 和 economics_get_cpi MCP 工具。兩者返回相同的數據結構，並消耗相同的月度配額。
端点與請求
REST 端點
GET /v1/economics/{country}/cpi請求範例
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP 使用工具 economics_get_cpi 使用下面對應的參數。
參數
此操作接受的期間格式是 YYYY-MM.
| 名稱 | 必填 | 類型 | 含義 |
|---|---|---|---|
country | 是 | 路徑·ISO alpha-3 | 支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。 |
period | 否 | 查詢·YYYY-MM | 省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。 |
回應
回應範例
{
"country": "USA",
"period": "2026-07",
"value": "333.918",
"base_period": "1982-84",
"base_value": "100",
"released_on": "2026-08-12"
}| 欄位 | 類型 | 必填 | 含義 |
|---|---|---|---|
country | 字串 | 是 | 所請求的大寫 ISO 三字母國家代碼。 |
period | 字串 | 是 | 返回的官方觀測期間。 |
value | 正數字串 | 是 | 總體指數水平。 |
base_period | 字串 | 是 | 官方指數基期。 |
base_value | 正數字串 | 是 | 官方指數基值。 |
released_on | 日期 | 是 | 官方發布日期，而不是 Narwhal 的檢索時間。 |
錯誤與配額
400 invalid_query— 國家、期間或篩選格式無效。401 invalid_api_key— Bearer 密鑰缺失或被拒絕。404 series_not_found— 沒有已批准的觀測值符合請求。429 rate_limit_exceeded— 已達到網路或帳戶短窗口限制；請在此時間後重試Retry-After.429 quota_exhausted— 帳戶已達到月度額度。503 economics_unavailable— Narwhal 無法安全提供已接受的發布版本。
只有成功的數據回應才會消耗配額。參見 所有錯誤、請求頭和重試規則.
新鮮度
省略 period 返回 Narwhal 最新儲存的已接受發布版本。API 呼叫讀取 Narwhal 數據庫，不會實時呼叫官方發布機構。
released_on 是官方發布日期。
當前公開測試覆蓋範圍
公開提供 AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA 的全國總體 CPI 數據。
印度尼西亞、區域路由和 Commodities 尚未公開。FX 可通過單獨的 FX API.
返回 所有經濟數據操作.