做一份各国通胀率对比

使用 API 完成操作

对要比较的每个国家使用 GET /v1/economics/{country}/inflation。每个响应都包含 period、year_over_year、month_over_month、year_to_date 和 released_on。构建对比表时，请把统计期间和发布日期放在数值旁边。

脚本在排序前把 year_over_year 转换为数字。它把国家代码、统计期间和发布日期保留在同一行，并将通胀率输出为一位小数。响应中也提供 month_over_month 和 year_to_date，但本次对比始终使用 year_over_year。

1. 获取并保存密钥 获取免费 API 密钥，并保存在环境变量 NARWHAL_API_KEY 中。请求针对基础 URL https://api.narwhalapi.com，使用 Authorization: Bearer YOUR_KEY。脚本从该变量读取密钥，并通过授权请求头发送。
2. 请求各国数据并对通胀率排序 用 Python 脚本请求美国、英国、德国、加拿大、日本和澳大利亚的通胀率。脚本为每个国家发出一次请求，从每个成功的响应中取出同比数值，并按从高到低的顺序连同统计期间和发布日期一起输出。
   Python：六国最新通胀率

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   rows = []
   for country in ["USA", "GBR", "DEU", "CAN", "JPN", "AUS"]:
       r = requests.get(
           f"https://api.narwhalapi.com/v1/economics/{country}/inflation",
           headers=H,
           timeout=10,
       )
       if r.ok:
           d = r.json()
           rows.append(
               (float(d["year_over_year"]), country, d["period"], d["released_on"])
           )
   
   for yoy, country, period, released in sorted(rows, reverse=True):
       print(f"{country}  {yoy:>4.1f}%  {period}  released {released}")

3. 查看每个通胀率旁边的日期 用 period 标明该通胀率对应的月份，用 released_on 标明发布日期。当统计期间不同时，请把这一差异写进你的仪表板或报告，让读者看清比较的是哪些月份。对行排序时，要让这两个日期始终跟随各自的国家。
4. 在报告中使用排序后的输出 每一行输出依次是国家代码、同比通胀率、统计期间和发布日期。在仪表板或报告中就按这个顺序排名；每次有新数据发布后运行脚本，更新对比。从输出中复制某一行时，请务必在百分数旁标明统计期间。

使用电子表格或手动计算

如果想一眼看到已公布的通胀率，可以使用网站上的各国通胀率表，或打开各国的通胀率页面。想自己排列各国时，把数值粘贴到表格中，包含国家列、同比通胀率、统计期间和发布日期，然后按通胀率从高到低排序。

排序时请整行一起移动，使通胀率始终与其国家和日期在一起。表格还能让你在查看排名时一直显示已公布的统计期间。如果报告要比较同一个月份，在计算利差前，请先用期间列找出属于该月份的行。若把期间不同的国家放进同一比较，要清楚标明差异。

不同情况应选哪种方法

为什么各国通胀率的统计期间不同？

各国按自己的时间表发布数据，因此在某一天可获得的发布数据可能对应不同的月份。2026 年 10 月 24 日，澳大利亚的 9 月数据尚未公布，所以可获得的月度通胀数字是 2026 年 8 月的。计算示例中的其他国家都有 2026 年 9 月的数字。

因此，跨这些发布数据的排名包含了期间差异。若要在该示例中对比 9 月，计算利差时请使用美国和日本的数字。如果把澳大利亚纳入更广泛的排名，要让它的 8 月标签清晰可见。

各国的 CPI 统计方法相同吗？

不相同。Narwhal 发布各国官方统计数据，各国的 CPI 是该国统计机构自己的指标，定义因国家而异。请按公布的数值直接对比，并阅读经济数据方法论了解这些指标背后的详细信息。

端点的字段名称一致，让你能把各个响应放进同一个对比中。解读排名时，请记住各国使用的是本国的统计口径：响应字段相同，并不意味着各国的 CPI 定义相同。

如果某个国家的通胀率返回 404 怎么办？

404 series_not_found 响应表示该通胀率序列未被覆盖，或尚未公布。2026 年 10 月 24 日，印度尼西亚和韩国的通胀率返回了这一错误。已覆盖国家的列表请查看覆盖范围页面。

跳过该国，并在报告中说明遗漏。被遗漏的国家在对比中没有通胀率，因此请把它从排名和利差计算中去掉。仅凭脚本成功的行无法解释某个国家为何缺席；请用错误响应来说明它缺失的原因。

计算示例：六国排名

从 2026 年 10 月 24 日可获得的发布数据开始。取出各国的同比通胀率，按从高到低排列各行，并在每个数值旁保留统计期间和发布日期。

对于 2026 年 10 月 24 日可获得的发布数据，这一组中最高的通胀率是澳大利亚 2026 年 8 月的 4.0%，最低的是日本 2026 年 9 月的 2.1%。完整排名的利差就使用这两个端点。对于 2026 年 9 月这一共同期间，则把美国的 3.7% 与日本的 2.1% 配对。

要得到 2026 年 10 月 24 日所有可获得发布数据之间的利差，用澳大利亚 2026 年 8 月的通胀率减去日本 2026 年 9 月的通胀率。然后用美国和日本 2026 年 9 月的通胀率计算美日利差。每个差值都以百分点表示，并在计算中保留统计期间标签。

Australia (August 2026) to Japan (September 2026):
4.0% - 2.1% = 1.9 percentage points

United States (September 2026) to Japan (September 2026):
3.7% - 2.1% = 1.6 percentage points