イールドカーブが逆転しているか確認する

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つのスプレッド(ベーシスポイント)、および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フィルターで1つの年限だけを返します。スクリプトのように両方の利回りを同じレスポンスで取得したい場合は、年限フィルターを付けないでください。米国のレスポンスでは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分の1ですか？

はい、1ベーシスポイントは1パーセントポイントの100分の1です。パーセントで表した利回りを引くと、パーセントポイントの差が得られます。その差に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年債の利回りを使い、続いてもう1つの一般的な比較として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か月債の利回りと組み合わせています。