如何检查收益率曲线倒挂

使用 API 完成操作

用较长期限的收益率减去较短期限的收益率。常用判断中，顺序保持为 10 年期减 2 年期：结果为负，说明 2 年期收益率更高。Python 脚本还会计算 10 年期减 3 个月期的利差，让你从同一条曲线读出两种比较。

美国曲线包含 1m、1.5m、2m、3m、4m、6m、1y、2y、3y、5y、7y、10y、20y 和 30y 这些期限。请用期限标签选出计算所需的收益率。响应中既包含常见倒挂判断所用的较短期限和较长期限，也包含美国曲线上的其他点。

1. 获取你的 API 密钥 获取免费密钥，并保存在环境变量 NARWHAL_API_KEY 中。请求使用 Authorization: Bearer YOUR_KEY，REST 与 MCP 共用同一个密钥。
2. 获取美国曲线并计算利差 使用 GET /v1/economics/USA/yield-curve 读取曲线的 date、curve_type 和 yields。脚本读取每个 maturity 和 yield_percent，然后输出日期、以基点表示的两个利差，以及 2 年期与 10 年期收益率的比较结果。
   Python：10 年期减 2 年期利差

   import os
   import requests
   
   curve = requests.get(
       "https://api.narwhalapi.com/v1/economics/USA/yield-curve",
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   ).json()
   y = {row["maturity"]: float(row["yield_percent"]) for row in curve["yields"]}
   print("curve date", curve["date"])
   print("10y - 2y  =", round((y["10y"] - y["2y"]) * 100), "bp")
   print("10y - 3m  =", round((y["10y"] - y["3m"]) * 100), "bp")
   print("inverted (2y > 10y):", y["2y"] > y["10y"])

3. 结合日期读取正负号 利差小于零，说明所选的这一对期限已倒挂。请把输出的曲线日期与结果一起保留，并在描述时写明所比较的期限。最后一行使用 2y > 10y，这与 10 年期减 2 年期利差为负是同一个条件。
4. 需要选择日期或期限时 使用 date 选择某一天，或使用可选的 maturity 筛选条件只返回一个期限。如果想像脚本那样在同一个响应中同时获得两个收益率，请不要使用期限筛选条件。美国的响应中 curve_type 为 nominal_par。对于历史区间，请对所需的每个期限使用历史端点。所有账户都可读取完整历史。

使用电子表格或手动计算

Narwhal 的债券收益率页面会展示曲线和利差。打开经济数据可进入相应页面；如果想自己做收益率相减，也可以使用电子表格。复制数值时请连同曲线日期一起保留，使结果对应某个明确的公布日。

把 10 年期收益率填入 B10，2 年期收益率填入 B8，数值保持 API 返回的样子。用下面的公式相减，结果以百分点为单位；乘以 100 即为以基点表示的利差。把数值移到其他单元格时，请保持相减的顺序。

=B10-B8

不同情况应选哪种方法

历史数据使用 GET /v1/economics/USA/yield-curve/history?start=...&end=...&maturity=...，所有账户均可获取完整历史。

应该用哪个利差来判断倒挂？

常用的判断有 10 年期减 2 年期和 10 年期减 3 个月期，两者可能不一致。由于“曲线倒挂”这个说法没有指明较短的期限，请在结果旁写明所用的组合。每种判断都是把 10 年期收益率与各自对应的较短期限比较。

2026 年 10 月 23 日，美国 10 年期减 2 年期利差为 +31 bp，10 年期减 3 个月期利差为 +78 bp，二者均为正。其他国家的期限不同：英国曲线从 0.5y 开始，以半年为间隔，因此请查看所请求国家返回的期限标签。

收益率曲线有多新？

响应中的 date 是最近一个已公布的日期，周末和节假日没有新的曲线。美国示例的日期是 2026 年 10 月 23 日，星期五。为利差加标签时请使用响应中的日期；你请求数据的那一天可能与曲线的公布日不同。

基点是百分点的百分之一吗？

是的，一个基点是一个百分点的百分之一。对以百分数表示的收益率相减，得到的是以百分点为单位的差值。将该差值乘以 100 即为基点，符号保持不变。2026 年 10 月 23 日，美国 10 年期减 2 年期的差值 0.31 个百分点等于 31 bp。

计算示例：2026 年 10 月 23 日

2026 年 10 月 23 日，美国曲线上 10 年期收益率为 5.00%，2 年期为 4.69%，3 个月期为 4.22%。两次相减都从 10 年期收益率出发。常用判断使用 2 年期收益率，另一种常见比较则用 3 个月期收益率重复一遍。

对于 2026 年 10 月 23 日，用 5.00% 减去 4.69% 得到 0.31 个百分点。将 0.31 乘以 100 得到 31 bp。正号表示 10 年期收益率高于 2 年期收益率，因此这一组合没有倒挂。同一天，用 5.00% 减去 4.22% 得到 0.78 个百分点，再乘以 100，即得到 10 年期减 3 个月期的利差为 78 bp。

2026 年 10 月 23 日，美国 20 年期收益率为 5.37%，30 年期为 5.33%。这些期限同样包含在返回的曲线中。这里的计算使用 10 年期收益率，分别与 2 年期和 3 个月期收益率搭配，进行常见的倒挂判断。