すべてのAPI

政策金利推移を調べる金利API

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

稼働中99.94% uptime, last 30日378 ms 標準応答

最初のリクエスト

イールドカーブを取得する

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国債利回り曲線/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 は次のページがないことを示します。