GDP 增长率计算：由 GDP 水平求得

使用 API 完成操作

水平使用 GDP 观测值端点，实际增长使用 GDP 增长端点。Python 示例请求从 2026-Q1 起的美国水平和 2026-Q2 的实际增长，因此两个计算指向同一个季度。比较时请把这些期间标签与结果放在一起。每个观测值的 value 是以 USD 表示的 GDP 水平。增长响应以百分比报告，所以请结合字段名称来理解单位：水平和增长百分比衡量的是经济的不同指标。

1. 设置你的 API 密钥 获取免费 API 密钥，并放入 NARWHAL_API_KEY 环境变量。脚本会读取该变量，并通过 Authorization: Bearer YOUR_KEY 请求头发送密钥。
2. 请求水平和实际增长 用 Python 脚本获取 GDP 观测值和实际增长的响应。它按期间保存观测值，所以相除时以2026年第二季度为分子、第一季度为分母。
   Python，由水平算出名义增长，并从 API 获取实际增长

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1/economics/USA"
   gdp = {
       o["period"]: float(o["value"])
       for o in requests.get(
           f"{API}/gdp/observations", params={"start": "2026-Q1"}, headers=H, timeout=10
       ).json()["observations"]
   }
   growth = requests.get(
       f"{API}/gdp-growth", params={"period": "2026-Q2"}, headers=H, timeout=10
   ).json()
   
   q = gdp["2026-Q2"] / gdp["2026-Q1"] - 1
   print(f"nominal GDP, Q2 vs Q1: {q:.2%}   as an annual rate: {(1 + q) ** 4 - 1:.2%}")
   print(
       f"real GDP growth from the API: {growth['quarter_over_quarter']}% on the quarter, "
       f"{growth['year_over_year']}% on the year"
   )

3. 查看名义增长的计算 变量 q 保存季度水平之间的变化，第一条 print 语句把它以百分比输出。年化率的计算是对同一个季度变化复利换算，不会剔除水平中包含的价格变动。
4. 查看实际增长的响应 quarter_over_quarter 字段是以百分比表示的实际增长，未做年化。year_over_year 字段给出实际同比百分比，请选用与你要比较的区间相符的字段。

使用电子表格或手动计算

把较早季度的 GDP 水平放在 B2，较晚季度的水平放在 B3。对于美国2026年第二季度的比较，B2 是第一季度水平 31,906,274,000,000 USD，B3 是第二季度水平 32,563,030,000,000 USD。这与 Python 计算中使用的水平相同。用较晚的值除以较早的值，再减 1。把结果设为百分比格式，表格就以与计算示例相同的形式呈现变化。公式引用单元格，所以请让它们的顺序与你要比较的期间一致。

=B3/B2-1

要把这个季度变化换算成年化率，对同样的单元格使用下面的公式。两种计算都要在单元格中保留完整的水平；年化公式直接用它们的比值计算。

=(B3/B2)^4-1

计算同比增长时，除以四个季度之前的水平再减 1。这改变的是比较期间，但使用的仍是现价水平，所以即使跨度是一年，结果仍然是名义增长。

不同情况应选哪种方法

为什么由水平算出的 GDP 增长与头条数字不同？

水平按现价计算，包含价格上涨；而头条指标是按不变价格计算的实际增长。如果想得到剔除这一部分的增长，GDP 增长端点提供实际增长的对比。

2026年第二季度，名义季度环比结果为 2.06%，实际结果为 0.55%，两者相差 1.51 个百分点。这一差距反映了现价水平中包含的价格上涨；粗略地减去通胀率不能替代价格指数。

季度 GDP 增长需要年化吗？

只有想做年化率的比较时才需要年化。美国的头条数字通常按年化报告，而 API 的 quarter_over_quarter 字段未做年化。比较数字之前，除了季度，还要让增长率的表示方式保持一致。

GDP 观测值带有 annualized: true，因为每个水平都以年率表示。把一个季度水平除以另一个，得到的仍是季度环比变化。把这个比值做四次方再减 1，可将变化换算成年化率，但它不是同比增长。

可以用名义 GDP 衡量经济规模吗？

可以，GDP 水平以现价 USD 衡量名义规模。需要这一规模时使用水平，需要它在选定区间内的名义变化时，则比较各个水平。要比较按数量计算的增长，请使用 GDP 增长端点的实际增长数据。

计算示例：美国2026年第二季度

从美国2026年第一季度和第二季度的 GDP 水平开始。两个值都是以 USD 表示的年率。在减 1 或换算成年化率之前，先用第二季度的值除以第一季度的值。

第二季度水平除以第一季度水平，得到比值 1.020583。商减 1 得到名义变化，以百分比表示：2026年第二季度比第一季度增长 2.06%。计算使用完整的水平，并保留未四舍五入的商用于年化率计算。

要把美国2026年第二季度的变化换算成年化率，将未四舍五入的商做四次方再减 1，结果为 8.49%。另外，2026-Q2 的实际季度环比增长字段为 0.55%。把名义季度数字与这个实际季度数字相比：2.06% 减 0.55%，差距为 1.51 个百分点。