すべてのAPI

国債のイールドカーブデータAPI

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

無料のAPIキーを取得
ドキュメントを読む →
稼働中100.00% uptime, last 30日324 ms 標準応答

最初のリクエスト

Get the United Kingdomのイールドカーブ

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"

Get the United Statesのイールドカーブ

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"

Get the Germanyのイールドカーブ

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"

Get the Japanのイールドカーブ

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"

Get the Canadaのイールドカーブ

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"

Get the Swedenのイールドカーブ

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"

Get the Norwayのイールドカーブ

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"

Get the Australiaのイールドカーブ

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"

Get the Euro areaのイールドカーブ

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"

履歴を取得する

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

エンドポイント

GET国債利回り曲線/v1/economics/{country}/yield-curve

1つの国の1件の観測値。最新のもの、または指定した正確な提供元の日付のもの。

パラメータ

  • country必須

    3文字コード: USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。

  • date任意

    省略すると、受理済みの最新の観測値を返します。値を指定すると、その期間が正確に選択されます。利用できない期間は404を返します。

  • version_id任意

    任意。変更不可の公開バージョンです。省略すると、現在受理済みのカーブを読み取ります。

  • 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を返します。

レスポンスフィールド

  • countryISO alpha-3の文字列

    リクエストされた国または地域です。

  • curve_type"nominal_par" | "nominal_zero_coupon" | "spot_svensson" | "constant_maturity_ytm" | "zero_coupon" | "constant_maturity_benchmark" | "spot_svensson_aaa"

    米国: 名目パー・イールド（米国財務省）。英国: 連続複利の名目ゼロクーポン利回り（イングランド銀行）。ドイツ: スヴェンソン・スポット利回り（ドイツ連邦銀行）。日本: 定年限JGB最終利回り（財務省(日本)）。カナダ: ゼロクーポン（割引）利回り（カナダ銀行）。スウェーデン: 短期国債・国債のベンチマーク利回り（スウェーデン国立銀行）。ノルウェー: 政府証券のゼロクーポン利回り（ノルウェー中央銀行）。オーストラリア: 国債の最終利回り（オーストラリア準備銀行）。ユーロ圏: AAA格付け国債のスポットレート（欧州中央銀行）。

  • dateYYYY-MM-DD形式の文字列

    このカーブのすべてのポイントに共通する、ソースの日付です。

  • yields配列

    利用可能な償還期間を、短い順に並べたものです。償還期間が1つだけの場合も配列のままです。

  • yields[].maturity文字列

    対応している償還期間ラベルのいずれかです。

  • yields[].tenor文字列

    tenor は標準的な期間で表した満期です。そのため、提供元が 6m や 0.5y と書いていても、6か月はどの国でも P6M になります。

  • yields[].yield_percent小数文字列

    利回り（パーセント）です。ソースの小数精度をそのまま保持します。

リファレンス全文 →
GET国債利回り曲線の履歴データ/v1/economics/{country}/yield-curve/history

範囲内のすべての観測値を古い順に、1ページあたり最大1,000件返します。null になるまで next_cursor をたどってください。

パラメータ

  • country必須

    3文字コード: USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。

  • start任意

    下限（この値を含む）です。省略すると、利用可能な最初の期間になります。

  • end任意

    上限（この値を含む）です。start より前にはできません。省略すると、利用可能な最後の期間になります。

  • limit任意

    デフォルトは100です。数えるのは日付または年で、個々の利回りポイントではありません。

  • cursor任意

    next_cursor は変更せず、同じ国、フィルター、limit とともに渡してください。カーソルは24時間で失効します。

  • as_of任意

    このUTC日の終わりまでに公開されていたとおりのカーブを返します。

  • 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を返します。

レスポンスフィールド

  • countryISO alpha-3の文字列

    リクエストされた国または地域です。

  • curve_type"nominal_par" | "nominal_zero_coupon" | "spot_svensson" | "constant_maturity_ytm" | "zero_coupon" | "constant_maturity_benchmark" | "spot_svensson_aaa"

    米国: 名目パー・イールド（米国財務省）。英国: 連続複利の名目ゼロクーポン利回り（イングランド銀行）。ドイツ: スヴェンソン・スポット利回り（ドイツ連邦銀行）。日本: 定年限JGB最終利回り（財務省(日本)）。カナダ: ゼロクーポン（割引）利回り（カナダ銀行）。スウェーデン: 短期国債・国債のベンチマーク利回り（スウェーデン国立銀行）。ノルウェー: 政府証券のゼロクーポン利回り（ノルウェー中央銀行）。オーストラリア: 国債の最終利回り（オーストラリア準備銀行）。ユーロ圏: AAA格付け国債のスポットレート（欧州中央銀行）。

  • observations配列

    古い順です。欠けている期間は含まれません。有効だがデータのない範囲は空の配列を返します。

  • observations[].dateYYYY-MM-DD形式の文字列

    このカーブのすべてのポイントに共通する、ソースの日付です。

  • observations[].yields配列

    利用可能な償還期間を、短い順に並べたものです。償還期間が1つだけの場合も配列のままです。

  • observations[].yields[].maturity文字列

    対応している償還期間ラベルのいずれかです。

  • observations[].yields[].tenor文字列

    tenor は標準的な期間で表した満期です。そのため、提供元が 6m や 0.5y と書いていても、6か月はどの国でも P6M になります。

  • observations[].yields[].yield_percent小数文字列

    利回り（パーセント）です。ソースの小数精度をそのまま保持します。

  • next_cursor文字列または null

    続きを取得するための不透明なトークンです。null は次のページがないことを示します。

リファレンス全文 →

ユースケース

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

2 つの利回りを比べ、スプレッドをベーシスポイントで読み取ります。

ガイドを読む →

実質金利を計算する

フィッシャー方程式で名目利回りからインフレ分を差し引きます。

ガイドを読む →

履歴のバックフィル

系列全体をページ単位でダウンロードし、止まったら再開します。

ガイドを読む →

カバレッジ

  • 米国名目パー利回り。1990年1月2日から日次。
  • 英国連続複利の名目ゼロクーポン利回り。1979年1月2日から日次。
  • ドイツSvensson スポット利回り。1997年8月7日から日次。
  • 日本定期償還の固定年限JGB最終利回り。1974年から日次。
  • カナダゼロクーポン(割引)利回り。1986年1月2日から日次。
  • スウェーデン政府短期証券および国債のベンチマーク利回り。1983年1月3日から日次。
  • ノルウェー政府証券のゼロクーポン利回り。2015年1月2日から日次。
  • オーストラリア国債の最終利回り。2013年5月20日から日次。
  • ユーロ圏AAA格付け国債のスポットレート。2004年9月6日から日次。

ソース

Japan's yield data is reused under Public Data License 1.0. Narwhal formats the source data for the API. This version was not created by the Ministry of Finance, Japan. Source licence

Source: Sveriges Riksbank. The data date is shown alongside the data. Narwhal has no official collaboration or partnership with the Riksbank.

Source: Norges Bank. Values are shown as published.

Source Reserve Bank of Australia 2026. The RBA publishes this data free of charge at rba.gov.au and does not endorse Narwhal.

Source: ECB. The ECB publishes this data free of charge at ecb.europa.eu, and values are shown as published.

関連 API

経済データAPI

価格、労働、産出、貿易、金利の公式指標。

APIを見る →

経済指標発表カレンダー

発表スケジュール、ステータス、公開データのバージョン。

APIを見る →

よくある質問

データはどのくらいの頻度で更新されますか。

米国財務省のカーブは、同省の日次公表に従います。イングランド銀行は、翌営業日の Europe/London の正午までの公表を目標としています。ドイツ連邦銀行は日次でカーブを公表します。財務省(日本)は、翌営業日の日本時間9時30分に公表します。カナダ銀行は、おおむね週に1回、観測日から約2〜3週間後にカーブを公表します。最新のカーブは通常、2〜3週間前のものです。スウェーデン国立銀行は営業日ごとに公表します。ノルウェー中央銀行も営業日ごとに公表します。オーストラリア準備銀行は、営業日に表F2を公表し、通常は2日以内です。欧州中央銀行は、翌営業日にカーブを公表します。週末や祝日には新しいカーブがない場合があります。ソースの値は改定されることがあります。ソースを確認しても、新しい観測値があるとは限りません。

値が欠けている場合はどうなりますか。

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

国によって利回り曲線が異なるのはなぜですか？

カーブの指標は国によって異なります。値ごとに、ソース、カーブの種類、満期を保持してください。

国によって、2つ目のカーブを提供していますか。

Norway: Use curve_type=constant_maturity_benchmark for Norges Bank generic rates: Treasury bills at 3, 6 and 12 months and government bonds at 3, 5, 7 and 10 years. 過去データは2019年1月2日から提供されています。Australia: Use curve_type=zero_coupon for RBA table F17 zero-coupon yields, from 0.25 to 10 years in quarter-year steps. 過去データは2017年1月3日から提供され、RBA は各行の日付から約1か月後にその行を追加します。Euro area: Use curve_type=spot_svensson_all_issuers for the ECB curve covering all euro area central government issuers: 3, 6 and 9 months, then 1 to 30 years in yearly steps, with daily history from 6 September 2004.

履歴はどのようにページ送りしますか。

開始日と終了日を含めて指定してください。レスポンスは古い順で、1ページあたり最大1,000のソース日付です。null になるまで、同じフィルターと limit で next_cursor をたどってください。カーソルは公開時点のスナップショットを最大24時間保持します。期限切れまたは取り下げられたスナップショットは409を返すので、カーソルなしでやり直してください。