イールドカーブAPIリファレンス

REST と MCP を通じて、9つの国と地域の国債利回り曲線を取得できます。1つのソース日付のデータ、またはページ分割された過去データを、小数表記のパーセント値の文字列で取得できます。

リクエスト

GET /v1/economics/{country}/yield-curve

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

米国リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

ドイツリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/DEU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

日本リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/JPN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

カナダリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/CAN/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

スウェーデンリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/SWE/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

ノルウェーリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/NOR/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

オーストラリアリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/AUS/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

ユーロ圏リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/EMU/yield-curve?date=2026-09-10&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

REST and MCP use the same Bearer key, response schema and credit balance. MCP tool: economics_get_yield_curve。

パラメータ

名前	種別	必須	意味
`country`	パス · ISO alpha-3	はい	対応する国コード: USA, GBR, DEU, JPN, CAN, SWE, NOR, AUS, EMU。米国: 名目パー・イールド（米国財務省）。英国: 連続複利の名目ゼロクーポン利回り（イングランド銀行）。ドイツ: スヴェンソン・スポット利回り（ドイツ連邦銀行）。日本: 定年限JGB最終利回り（財務省(日本)）。カナダ: ゼロクーポン（割引）利回り（カナダ銀行）。スウェーデン: 短期国債・国債のベンチマーク利回り（スウェーデン国立銀行）。ノルウェー: 政府証券のゼロクーポン利回り（ノルウェー中央銀行）。オーストラリア: 国債の最終利回り（オーストラリア準備銀行）。ユーロ圏: AAA格付け国債のスポットレート（欧州中央銀行）。
`date`	YYYY-MM-DD形式の文字列	いいえ	省略すると、受理済みの最新の観測値を返します。値を指定すると、その期間が正確に選択されます。利用できない期間は404を返します。
`version_id`	UUID文字列	いいえ	任意。変更不可の公開バージョンです。省略すると、現在受理済みのカーブを読み取ります。
`curve_type`	文字列	いいえ	任意。curve_type は両方のルートでカーブを指定します。対象は、それぞれ2種類のカーブを提供する NOR、AUS、EMU のみです。省略すると最初のカーブとなり、レスポンスの curve_type にその名前が入ります。その国が提供しないカーブを指定すると400エラーになります。
`maturity`	カンマ区切りの文字列	いいえ	任意。両方のルートで使用できます。省略すると、利用可能なカーブ全体を返します。USA: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y。GBR: 0.5y, 1y, 1.5y, 2y, 2.5y, 3y, 3.5y, 4y, 4.5y, 5y, 5.5y, 6y, 6.5y, 7y, 7.5y, 8y, 8.5y, 9y, 9.5y, 10y, 10.5y, 11y, 11.5y, 12y, 12.5y, 13y, 13.5y, 14y, 14.5y, 15y, 15.5y, 16y, 16.5y, 17y, 17.5y, 18y, 18.5y, 19y, 19.5y, 20y, 20.5y, 21y, 21.5y, 22y, 22.5y, 23y, 23.5y, 24y, 24.5y, 25y, 25.5y, 26y, 26.5y, 27y, 27.5y, 28y, 28.5y, 29y, 29.5y, 30y, 30.5y, 31y, 31.5y, 32y, 32.5y, 33y, 33.5y, 34y, 34.5y, 35y, 35.5y, 36y, 36.5y, 37y, 37.5y, 38y, 38.5y, 39y, 39.5y, 40y。DEU: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y。JPN: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 15y, 20y, 25y, 30y, 40y。CAN: 0.25y, 0.5y, 0.75y, 1y, 1.25y, 1.5y, 1.75y, 2y, 2.25y, 2.5y, 2.75y, 3y, 3.25y, 3.5y, 3.75y, 4y, 4.25y, 4.5y, 4.75y, 5y, 5.25y, 5.5y, 5.75y, 6y, 6.25y, 6.5y, 6.75y, 7y, 7.25y, 7.5y, 7.75y, 8y, 8.25y, 8.5y, 8.75y, 9y, 9.25y, 9.5y, 9.75y, 10y, 10.25y, 10.5y, 10.75y, 11y, 11.25y, 11.5y, 11.75y, 12y, 12.25y, 12.5y, 12.75y, 13y, 13.25y, 13.5y, 13.75y, 14y, 14.25y, 14.5y, 14.75y, 15y, 15.25y, 15.5y, 15.75y, 16y, 16.25y, 16.5y, 16.75y, 17y, 17.25y, 17.5y, 17.75y, 18y, 18.25y, 18.5y, 18.75y, 19y, 19.25y, 19.5y, 19.75y, 20y, 20.25y, 20.5y, 20.75y, 21y, 21.25y, 21.5y, 21.75y, 22y, 22.25y, 22.5y, 22.75y, 23y, 23.25y, 23.5y, 23.75y, 24y, 24.25y, 24.5y, 24.75y, 25y, 25.25y, 25.5y, 25.75y, 26y, 26.25y, 26.5y, 26.75y, 27y, 27.25y, 27.5y, 27.75y, 28y, 28.25y, 28.5y, 28.75y, 29y, 29.25y, 29.5y, 29.75y, 30y。SWE: 1m, 3m, 6m, 2y, 5y, 7y, 10y。NOR: 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y。AUS: 2y, 3y, 5y, 10y。EMU: 3m, 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y。重複は除かれ、期間は昇順に並べ替えられます。対応していないラベルは400を返します。

レスポンス

レスポンスの例保存済みのソースサンプル · ライブリクエストではありません

{
  "country": "GBR",
  "curve_type": "nominal_zero_coupon",
  "date": "2026-09-10",
  "yields": [
    {
      "maturity": "2y",
      "tenor": "P2Y",
      "yield_percent": "4.6509003413966044"
    },
    {
      "maturity": "10y",
      "tenor": "P10Y",
      "yield_percent": "5.3572243604351168"
    }
  ]
}

フィールド	種別	意味
`country`	ISO alpha-3の文字列	リクエストされた国または地域です。
`curve_type`	"nominal_par" \| "nominal_zero_coupon" \| "spot_svensson" \| "constant_maturity_ytm" \| "zero_coupon" \| "constant_maturity_benchmark" \| "spot_svensson_aaa"	米国: 名目パー・イールド（米国財務省）。英国: 連続複利の名目ゼロクーポン利回り（イングランド銀行）。ドイツ: スヴェンソン・スポット利回り（ドイツ連邦銀行）。日本: 定年限JGB最終利回り（財務省(日本)）。カナダ: ゼロクーポン（割引）利回り（カナダ銀行）。スウェーデン: 短期国債・国債のベンチマーク利回り（スウェーデン国立銀行）。ノルウェー: 政府証券のゼロクーポン利回り（ノルウェー中央銀行）。オーストラリア: 国債の最終利回り（オーストラリア準備銀行）。ユーロ圏: AAA格付け国債のスポットレート（欧州中央銀行）。
`date`	YYYY-MM-DD形式の文字列	このカーブのすべてのポイントに共通する、ソースの日付です。
`yields`	配列	利用可能な償還期間を、短い順に並べたものです。償還期間が1つだけの場合も配列のままです。
`yields[].maturity`	文字列	対応している償還期間ラベルのいずれかです。
`yields[].tenor`	文字列	`tenor` は満期を標準の期間表記で示します。そのため、ソースが 6m と書いても 0.5y と書いても、6 か月はどの国でも P6M になります。
`yields[].yield_percent`	小数文字列	利回り（パーセント）です。ソースの小数精度をそのまま保持します。

値は 10 進数の文字列のまま保持されます。ソースのタイムスタンプや公開日が補われることはありません。Request IDs, cost and balance are returned in headers.

APIエラーとクレジット

ステータス	意味
`400`	国の指定形式、日付、年、範囲、満期、limit、カーソルのいずれかが無効です。
`401`	API キーがないか、拒否されました。
`404`	指定した日付、年、範囲、または選択した満期に一致する観測値がありません。
`429`	レート制限に達しました。
`503`	受け付けたデータを安全に提供できません。

A successful response costs one call, including an empty history result. Errors cost nothing. 共通のエラーとヘッダー →

対象範囲と鮮度

米国 · USA, 英国 · GBR, ドイツ · DEU, 日本 · JPN, カナダ · CAN, スウェーデン · SWE, ノルウェー · NOR, オーストラリア · AUS, ユーロ圏 · EMU · 米国: 1990年1月2日以降 · 英国: 1979年1月2日以降 · ドイツ: 1997年8月7日以降 · 日本: 1974年以降 · カナダ: 1986年1月2日以降 · スウェーデン: 1983年1月3日以降 · ノルウェー: 2015年1月2日以降 · オーストラリア: 2013年5月20日以降 · ユーロ圏: 2004年9月6日以降。米国財務省のカーブは、同省の日次公表に従います。イングランド銀行は、翌営業日の Europe/London の正午までの公表を目標としています。ドイツ連邦銀行は日次でカーブを公表します。財務省(日本)は、翌営業日の日本時間9時30分に公表します。カナダ銀行は、おおむね週に1回、観測日から約2〜3週間後にカーブを公表します。最新のカーブは通常、2〜3週間前のものです。スウェーデン国立銀行は営業日ごとに公表します。ノルウェー中央銀行も営業日ごとに公表します。オーストラリア準備銀行は、営業日に表F2を公表し、通常は2日以内です。欧州中央銀行は、翌営業日にカーブを公表します。週末や祝日には新しいカーブがない場合があります。ソースの値は改定されることがあります。ソースを確認しても、新しい観測値があるとは限りません。

欠けている償還期間は含まれません。Narwhal は、ソースにないポイントを補完したり、古いカーブで代用したり、値を作り出したりすることは一切ありません。

米国: 名目パーイールド。日次の履歴の開始日: 1990年1月2日。満期: 1か月から30年。

ソース：米国財務省

英国: 連続複利の名目ゼロクーポン利回り。日次の履歴の開始日: 1979年1月2日。満期: 0.5年から40年まで、0.5年刻み。

ソース：イングランド銀行

ドイツ: スベンソン・モデルによるスポット利回り。日次の履歴の開始日: 1997年8月7日。満期: 1年から30年まで、1年刻み。

ソース：ドイツ連邦銀行

日本: 固定満期の日本国債の最終利回り。日次の履歴の開始日: 1974。満期: 1年から10年まで、その後15年、20年、25年、30年、40年。

ソース：日本の財務省

日本の利回りデータは、公共データ利用規約（第1.0版）に基づいて再利用しています。Narwhal は、ソースデータを API 向けに整形しています。このバージョンは財務省(日本)が作成したものではありません。ソースのライセンス

カナダ: ゼロクーポン（割引）利回り。日次の履歴の開始日: 1986年1月2日。満期: 0.25年から30年まで、0.25年刻み（1991年より前は25年まで）。

ソース：カナダ銀行