所有 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"
}

来源与方法论

明确的期间

省略此参数可获取最新已接受的完整发布,或传入一个精确期间。

REST 和 MCP

使用一个 API 密钥,通过 REST 或 MCP 获取最新及历史数据。

常见问题

CPI 和通胀率相同吗?

CPI 表示指数水平,而通胀率衡量价格的百分比变化;如需通胀率,请使用通胀 API。

可以比较不同国家的 CPI 数值吗?

比较指数水平前,请检查 base_period 和 base_value:各国可能采用不同的基期和基值。

如何请求最新 CPI?

省略 period 可获取已接受的最新完整发布数据,或使用 YYYY-MM 指定月份。

发起你的第一个请求

获取免费 API 密钥