消费者价格指数 (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.
返回 所有经济数据操作.