比较各国通胀
把最新的通胀率排序，并保留每次发布的日期。
阅读指南 →所有 API
通胀数据 API：物价与 CPI 总览
通过 REST 或 MCP 按国家查询官方 CPI 和通胀数据，通胀数据 API 可返回最新已确认数值、指定期间数值或带日期的历史。
首次请求
获取最新值
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"端点
GET消费者价格指数/v1/economics/{country}/cpi
获取某个国家某个月份的居民消费价格总指数。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period可选省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
version_id可选可选的不可变发布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略则读取当前已收录的指标。
响应字段
country字符串所请求的大写 ISO 三字母国家代码。
period字符串返回的官方观测期间。
value表示正数的十进制字符串总体指数水平。
index_base字符串指数的基期和基值，例如 1982-84=100。
released_on日期官方发布日期，而不是 Narwhal 的检索时间。
source对象可选的 source 对象仅在统计数据经由分发方获得时出现，包含 publisher（分发方所注明的原始发布方）和 distributor（分发机构）。存在 source 时，released_on 是分发方的发布日期，而不是原始发布方的发布日期。由发布方直接提供的序列没有 source。
完整参考文档 →
GET居民消费价格指数历史数据/v1/economics/{country}/cpi/observations
获取一个国家当前已接受的居民消费价格指数时间序列。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
start可选起始观测期（包含该期）。
end可选结束观测期（包含该期）。
limit可选返回的最大期间数。默认值为 100。页面可能包含更少的期间；请继续使用 next_cursor。
cursor可选上一页返回的next_cursor。
version可选只接受 first_reported：返回每个期间首次存储的值，并附带 first_reported_at。不能与 as_of 同时使用。
as_of可选返回截至指定 UTC 日终时已发布的序列。不能与 version 同时使用。
响应字段
country字符串请求的大写 ISO alpha-3 国家代码。每页返回一次，不在每条观测记录中重复。
start字符串仅当 Narwhal 将请求的 start 推迟到更晚的期间时出现。不会返回更早的期间。
as_ofRFC 3339 时间戳来源最后更新本页最新观测值的时间，精确到整秒，使用 UTC。
source对象通过分发机构获取的统计数据的来源信息；请参阅最新值操作。
index_base字符串指数的基期和基值，例如 1982-84=100。一页不会包含两种不同基准的数据。
observations数组按时间从早到晚排列的已采纳观测记录，每个期间一条。来源缺失的值会被省略，绝不填补。每页观测记录数可能小于 limit；请继续使用 next_cursor，直到其值为 null。
observations[].period字符串观测值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 时间戳仅在 version=first_reported 时出现。这个 UTC 时间戳记录 Narwhal 首次存储该期间的时间（如果各项指标是分开存储的，则取最晚的时间）。在开始采集之前发布的期间，显示的是 Narwhal 的首次采集时间。
observations[].value十进制字符串已采纳的指数水平，不经过二进制浮点转换。
next_cursor字符串或 null将此值原样作为 cursor 传入，以读取下一页；最后一页为 null。
完整参考文档 →
GET通胀/v1/economics/{country}/inflation
获取某一个月的同比、环比和年初至今通胀率。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period可选省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
version_id可选可选的不可变发布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略则读取当前已收录的指标。
响应字段
country字符串所请求的大写 ISO 三字母国家代码。
period字符串返回的官方观测期间。
year_over_year十进制字符串与上年同月相比的变化率，单位为百分比。
month_over_month十进制字符串与上月相比的变化率，单位为百分比。
year_to_date十进制字符串与上年十二月相比的变化率，单位为百分比。发布机构未发布时省略。
released_on日期官方发布日期，而不是 Narwhal 的检索时间。
source对象可选的 source 对象仅在统计数据经由分发方获得时出现，包含 publisher（分发方所注明的原始发布方）和 distributor（分发机构）。存在 source 时，released_on 是分发方的发布日期，而不是原始发布方的发布日期。由发布方直接提供的序列没有 source。
完整参考文档 →
GET通胀历史数据/v1/economics/{country}/inflation/observations
获取一个国家当前已接受的通胀时间序列。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
start可选起始观测期（包含该期）。
end可选结束观测期（包含该期）。
limit可选返回的最大期间数。默认值为 100。页面可能包含更少的期间；请继续使用 next_cursor。
cursor可选上一页返回的next_cursor。
version可选只接受 first_reported：返回每个期间首次存储的值，并附带 first_reported_at。不能与 as_of 同时使用。
as_of可选返回截至指定 UTC 日终时已发布的序列。不能与 version 同时使用。
响应字段
country字符串请求的大写 ISO alpha-3 国家代码。每页返回一次，不在每条观测记录中重复。
start字符串仅当 Narwhal 将请求的 start 推迟到更晚的期间时出现。不会返回更早的期间。
as_ofRFC 3339 时间戳来源最后更新本页最新观测值的时间，精确到整秒，使用 UTC。
source对象通过分发机构获取的统计数据的来源信息；请参阅最新值操作。
observations数组按时间从早到晚排列的已采纳观测记录，每个期间一条。来源缺失的值会被省略，绝不填补。每页观测记录数可能小于 limit；请继续使用 next_cursor，直到其值为 null。
observations[].period字符串观测值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 时间戳仅在 version=first_reported 时出现。这个 UTC 时间戳记录 Narwhal 首次存储该期间的时间（如果各项指标是分开存储的，则取最晚的时间）。在开始采集之前发布的期间，显示的是 Narwhal 的首次采集时间。
observations[].year_over_year十进制字符串与上年同月相比的变化率，单位为百分比。
observations[].month_over_month十进制字符串与上月相比的变化率，单位为百分比。
observations[].year_to_date十进制字符串与上年十二月相比的变化率，单位为百分比。发布机构未发布时省略。
next_cursor字符串或 null将此值原样作为 cursor 传入，以读取下一页；最后一页为 null。
完整参考文档 →
使用场景
覆盖范围
指标
国家
来源
- 澳大利亚澳大利亚统计局（ABS）
- 奥地利奥地利统计局、欧盟统计局（Eurostat）
- 比利时比利时统计局（Statbel）、比利时国家银行、欧盟统计局（Eurostat）
- 加拿大加拿大统计局
- 瑞士瑞士联邦统计局(FSO)、Eurostat
- 智利智利中央银行（BCCh）、智利国家统计局（INE）
- 哥伦比亚国家统计行政部（DANE）
- 捷克捷克统计局（ČSÚ）
- 德国德国联邦统计局（Destatis）
- 丹麦丹麦统计局、欧盟统计局（Eurostat）
- 西班牙西班牙国家统计局（INE）、西班牙税务局（AEAT）
- 爱沙尼亚爱沙尼亚统计局
显示全部 36 个来源
- 芬兰芬兰统计局、芬兰海关（Tulli）
- 法国法国国家统计与经济研究院（INSEE）、法国海关
- 英国英国国家统计局（ONS）
- 克罗地亚克罗地亚统计局（CBS）
- 爱尔兰中央统计局（CSO）
- 意大利意大利国家统计局（Istat）、欧盟统计局（Eurostat）
- 日本日本统计局、日本内阁府、日本 Customs
- 立陶宛立陶宛国家数据局
- 卢森堡STATEC、欧盟统计局（Eurostat）
- 拉脱维亚拉脱维亚中央统计局（CSB）
- 墨西哥国家统计、地理和信息研究所（INEGI）
- 马来西亚马来西亚统计局（DOSM）
- 荷兰荷兰统计局（CBS）
- 挪威挪威统计局（SSB）
- 菲律宾菲律宾统计局（PSA）
- 波兰波兰统计局、欧盟统计局（Eurostat）
- 葡萄牙葡萄牙统计局（INE）
- 卡塔尔National Planning Council (NPC)，经由 Qatar Open Data 门户
- 沙特阿拉伯统计总局（GASTAT）
- 新加坡新加坡统计局（SingStat）、新加坡政府发布的开放数据
- 斯洛文尼亚斯洛文尼亚共和国统计局（SURS）
- 瑞典瑞典统计局（SCB）
- 美国劳工统计局（BLS）、经济分析局（BEA）、美国人口普查局
- 巴基斯坦巴基斯坦统计局（PBS）
相关 API
常见问题
CPI 水平值和通胀率都能获取吗？
是。实时覆盖包括 CPI 指数水平值和通胀率。
可以请求特定的统计期吗？
是。你可以请求确切期间、获取带日期的历史，或查询最新已确认数值。
这些统计数据来自哪里？
它们是来自各国官方发布机构的官方统计数据，按国家整理。
从免费密钥开始
12 个月内每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。