所有 API

消費者物價指數 API

來自十個國家官方機構的月度 CPI 資料。

首次請求

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

回應範例示例回應 · 並非實時請求

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

端點

GET消費者價格指數/v1/economics/{country}/cpi

country: 支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period: 省略此參數可獲取最新已接受的完整發布，或傳入一個精確期間。

MCP · economics_get_cpi

API 參考 →

GET消費者價格指數歷史/v1/economics/{country}/cpi/observations

country: 支援的一個大寫國家代碼：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
start: 包含的首個觀測期。
end: 包含的最後觀測期。
limit: 最多返回的觀測值數量。預設為 100。
cursor: 上一頁返回的next_cursor。

MCP · economics_get_cpi_history

API 參考 →

歷史

cURL

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

回應範例示例回應 · 並非實時請求

{
  "observations": [
    {
      "country": "USA",
      "measure": "cpi",
      "value": "333.918",
      "unit": "INDEX",
      "transformation": "",
      "period": "2026-07"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}