株式リスクプレミアムAPIリファレンス

国別の株式リスクプレミアムとカントリーリスクプレミアム

概要

Narwhalによる株式リスクプレミアムの推計：投資家がリスクフリーの国債に対して株式に求める上乗せ収益率です。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。

国は、USAやIDNのようなISO 3166 alpha-3コードで指定します。合計は成熟市場プレミアムにカントリーリスクプレミアムを加えたもので、カントリーリスクプレミアムは国のデフォルトスプレッドにボラティリティ比率を掛けたものです。比率を除き、すべての数値は小数第4位までの10進数の文字列で、単位はパーセントです。比率は単なる数値です。

各数値には根拠が付きます。市場データまたは公式データからの実測、モデル推計、または公表されたカントリーリスク表からの取得です。この表は方法のページが出典として示しています。方法、入力値、限界は株式リスクプレミアムの算出方法のページにあり、すべての回答がそこへリンクします。

ベースURL： https://api.narwhalapi.com。以下の各ルートは、同じパラメータを持つ独立したMCPツールです。

すべてのアカウントで利用できるもの

課金額	すべてのアカウント
国の最新値	含まれる
全国の最新値	含まれる
履歴	全期間の履歴

参照：料金表で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

A country appears only when we hold a row for it. Without a row the route returns 404 series_not_found; nothing is filled in or carried forward.
成熟市場にカントリーリスクプレミアムはありません。米国ではデフォルトスプレッドが0、ボラティリティ比率が空で、合計は成熟市場プレミアムと等しくなります。ユーロ圏の基準であるドイツのカントリーリスクプレミアムも0です。
数値は米ドル建てです。ほかの通貨の割引率には、2つの通貨のインフレ率の差を加える必要があります。
履歴は日付でページ分割されます。次のページを読むには、前のページの next_cursor を、ほかのパラメータは同じにして送ります。
数値は分析用の推計であり、金融、投資、法務、税務に関する助言ではありません。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

国の株式リスクプレミアムを取得

GET /v1/economics/{country}/equity-risk-premium

1か国の最新の株式リスクプレミアム、または date 以前で最新のものを返します。成熟市場プレミアム、国のデフォルトスプレッド、ボラティリティ比率、カントリーリスクプレミアム、合計で、それぞれに根拠が付きます。

date を送ると、その日以前で最新の値を読み取ります。

MCP: ツール economics_get_equity_risk_premium。

パラメータ

パラメータ	場所	必須	種別	意味
`country`	パス	はい	文字列
`date`	クエリ	いいえ	文字列

レスポンスフィールド

フィールド	種別	送信
`country`	文字列	常に
`as_of`	日付	常に
`unit`	always "percent"	常に
`mature_erp`	文字列	常に
`country_default_spread`	文字列	常に
`volatility_ratio`	文字列	常に
`country_risk_premium`	文字列	常に
`total_erp`	文字列	常に
`basis`	オブジェクト	常に
`basis.mature_erp`	次のいずれか: observed, modelled, table	常に
`basis.country_default_spread`	次のいずれか: observed, modelled, table	常に
`basis.volatility_ratio`	次のいずれか: observed, modelled, table	常に
`basis.country_risk_premium`	次のいずれか: observed, modelled, table	常に
`basis.total_erp`	次のいずれか: observed, modelled, table	常に
`methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	任意

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium"

{
  "country": "ITA",
  "as_of": "2026-10-28",
  "unit": "percent",
  "mature_erp": "3.2230",
  "country_default_spread": "0.8881",
  "volatility_ratio": "2.0310",
  "country_risk_premium": "1.8037",
  "total_erp": "5.0267",
  "basis": {
    "mature_erp": "observed",
    "country_default_spread": "observed",
    "volatility_ratio": "modelled",
    "country_risk_premium": "modelled",
    "total_erp": "modelled"
  },
  "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
}

株式リスクプレミアムの履歴を取得

GET /v1/economics/{country}/equity-risk-premium/history

1か国の株式リスクプレミアムを日付順（古い順）に返します。next_cursor でページ送りします。

MCP: ツール economics_get_equity_risk_premium_history。

パラメータ

パラメータ	場所	必須	種別	意味
`country`	パス	はい	文字列
`start`	クエリ	いいえ	文字列
`end`	クエリ	いいえ	文字列
`limit`	クエリ	いいえ	整数
`cursor`	クエリ	いいえ	文字列	前のページの `next_cursor`。ほかのパラメータは同じ値にします。

レスポンスフィールド

フィールド	種別	送信	意味
`country`	文字列	常に
`observations`	オブジェクトの配列	常に
`observations[].country`	文字列	常に
`observations[].as_of`	日付	常に
`observations[].unit`	always "percent"	常に
`observations[].mature_erp`	文字列	常に
`observations[].country_default_spread`	文字列	常に
`observations[].volatility_ratio`	文字列	常に
`observations[].country_risk_premium`	文字列	常に
`observations[].total_erp`	文字列	常に
`observations[].basis`	オブジェクト	常に
`observations[].basis.mature_erp`	次のいずれか: observed, modelled, table	常に
`observations[].basis.country_default_spread`	次のいずれか: observed, modelled, table	常に
`observations[].basis.volatility_ratio`	次のいずれか: observed, modelled, table	常に
`observations[].basis.country_risk_premium`	次のいずれか: observed, modelled, table	常に
`observations[].basis.total_erp`	次のいずれか: observed, modelled, table	常に
`observations[].methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	任意
`next_cursor`	文字列	常に	Pass as cursor to read the next page. Always sent; null on the last page.

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium/history?start=2026-01-01"

{
  "country": "ITA",
  "observations": [
    {
      "country": "ITA",
      "as_of": "2026-09-01",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    },
    {
      "country": "ITA",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    }
  ],
  "next_cursor": null
}

全国の株式リスクプレミアムを一覧

GET /v1/economics/equity-risk-premium

数値のあるすべての国の最新の株式リスクプレミアムを、国順で返します。

MCP: ツール economics_list_equity_risk_premium。

パラメータ

このルートにパラメーターはありません。

レスポンスフィールド

フィールド	種別	送信
`countries`	オブジェクトの配列	常に
`countries[].country`	文字列	常に
`countries[].as_of`	日付	常に
`countries[].unit`	always "percent"	常に
`countries[].mature_erp`	文字列	常に
`countries[].country_default_spread`	文字列	常に
`countries[].volatility_ratio`	文字列	常に
`countries[].country_risk_premium`	文字列	常に
`countries[].total_erp`	文字列	常に
`countries[].basis`	オブジェクト	常に
`countries[].basis.mature_erp`	次のいずれか: observed, modelled, table	常に
`countries[].basis.country_default_spread`	次のいずれか: observed, modelled, table	常に
`countries[].basis.volatility_ratio`	次のいずれか: observed, modelled, table	常に
`countries[].basis.country_risk_premium`	次のいずれか: observed, modelled, table	常に
`countries[].basis.total_erp`	次のいずれか: observed, modelled, table	常に
`countries[].methodology_url`	always "https://narwhalapi.com/methodology/equity-risk-premium"	任意

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/equity-risk-premium"

{
  "countries": [
    {
      "country": "DEU",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.0000",
      "volatility_ratio": "2.5462",
      "country_risk_premium": "0.0000",
      "total_erp": "3.2230",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "observed",
        "country_risk_premium": "observed",
        "total_erp": "observed"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    },
    {
      "country": "ITA",
      "as_of": "2026-10-28",
      "unit": "percent",
      "mature_erp": "3.2230",
      "country_default_spread": "0.8881",
      "volatility_ratio": "2.0310",
      "country_risk_premium": "1.8037",
      "total_erp": "5.0267",
      "basis": {
        "mature_erp": "observed",
        "country_default_spread": "observed",
        "volatility_ratio": "modelled",
        "country_risk_premium": "modelled",
        "total_erp": "modelled"
      },
      "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
    }
  ]
}

エラー

エラーは共通の problem 形式で返され、次のコードを含みます: request_id。参照： APIエラーとクレジットで形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。

コード	ステータス	意味
`invalid_query`	400	パラメータが欠けている、未知である、重複している、または範囲外です。
`series_not_found`	404	この国の株式リスクプレミアムは保有していません。
`invalid_cursor`	400	このカーソルは、このリクエストが返したものではないか、別のリクエストのものです。
`insufficient_credits`	402	クレジット残高が、リクエストの費用に足りません。
`economics_unavailable`	503	経済データがいま回答できません。しばらくしてからもう一度お試しください。

このページは役に立ちましたか?