政策金利APIリファレンス

リクエスト

GET /v1/economics/{country}/central-bank/policy-rate
GET /v1/economics/{country}/central-bank/policy-rate?date=2026-09-15
GET /v1/economics/{country}/central-bank/policy-rate/history?start=2008-01-01&limit=1000
GET /v1/economics/{country}/central-bank/reserves?period=2026-07
GET /v1/economics/{country}/central-bank/balance-sheet?period=2026-09

countryには大文字のISO alpha-3コードを使ってください。

dateを省略すると、UTCの今日以前にあるデータソースの最新の観測値を返します。dateを指定すると、指定日以前の最新の観測値を返します。観測値がない日は欠損のままとし、適用開始日が将来の金利で現在の金利を先に置き換えることはありません。

MCPツールはeconomics_get_policy_rate、economics_get_policy_rate_history、economics_get_central_bank_reserves、economics_get_central_bank_balance_sheetです。RESTとMCPはBearerキー、スキーマ、クォータを共有し、各リクエストを1回の呼び出しとして数えます。

政策金利はすべてのプランでリアルタイムに提供します。最新の金利には履歴制限がありませんが、date、履歴範囲、準備資産のperiod、またはバランスシートのperiodを指定したリクエストには、プランの履歴対象期間を適用します。Freeは12か月、Basicは5年、Proは全履歴です。終了時点が対象期間より前にあるリクエストは、403 plan_upgrade_requiredを返します。

レスポンス

例では保存済みの値を使ってレスポンスの形式を示しています。値はライブデータではありません。

{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.25",
  "qualifier": "exact",
  "unit": "percent",
  "effective_on": null,
  "observed_on": "2025-12-10",
  "announced_on": null
}

{
  "country": "USA",
  "authority": "federal_reserve",
  "currency": "USD",
  "instrument": "federal_funds_target_range",
  "rate_type": "range",
  "lower_bound": "3.50",
  "upper_bound": "3.75",
  "unit": "percent",
  "effective_on": "2025-12-11",
  "observed_on": null,
  "announced_on": null
}

単一金利にはrateとqualifierがあり、目標レンジには代わりにlower_boundとupper_boundがあります。値は年率パーセントを表す小数の文字列で、マイナス金利も有効です。

履歴

• startとend：両端を含む日付をYYYY-MM-DD形式で指定します。
• limit：1〜1000、デフォルトは100です。
• cursor：前のページのnext_cursorです。

結果は古い順に並びます。next_cursorがnullになるまで、同じフィルターと上限を使い、next_cursorをcursorとして送信して次のページを取得してください。カーソルは24時間、すべてのページを最初の公表データに固定します。それより古いカーソル、または中央銀行が撤回したデータは409 cursor_expiredを返します。カーソルを付けずに最初から取得してください。

レスポンスにはcountry、observations、next_cursorが含まれます。各観測値は、単一金利のレスポンスと同じフィールドを使います。

履歴リクエストでは、startをプランの履歴対象期間の開始時点まで繰り下げます。Freeは12か月、Basicは5年、Proは全履歴です。米国、オーストラリア、チェコ、カナダ、マレーシアは決定日のみを記録しており、履歴では対象期間より前の金利を期間内に繰り越しません。対象期間内に決定がない場合、レスポンスのobservationsリストは空（[]）となり、next_cursorはnullになります。dateを指定しない現行金利のリクエストでは、すべてのプランで履歴制限なく、現在適用されている金利を返します。

{
  "country": "USA",
  "observations": [
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target",
      "rate_type": "point",
      "rate": "1.00",
      "qualifier": "exact",
      "unit": "percent",
      "effective_on": "2008-10-29",
      "observed_on": null,
      "announced_on": null
    },
    {
      "country": "USA",
      "authority": "federal_reserve",
      "currency": "USD",
      "instrument": "federal_funds_target_range",
      "rate_type": "range",
      "lower_bound": "0.00",
      "upper_bound": "0.25",
      "unit": "percent",
      "effective_on": "2008-12-16",
      "observed_on": null,
      "announced_on": null
    }
  ],
  "next_cursor": "eyJhIjoiMjAwOC0xMi0xNiJ9"
}

外貨準備

中央銀行が公表する公式準備資産の総額を返します。periodにはYYYY-MMを指定してください。省略すると最新月を取得します。

{
  "country": "AUS",
  "period": "2026-07",
  "value": "145344",
  "currency": "AUD",
  "scale": "millions",
  "released_on": "2026-08-07"
}

valueは正の小数を表す文字列です。中央銀行の公表単位に応じて、scaleはunitsまたはmillionsになります。currencyは値の通貨を示します。Narwhalが桁や通貨を変換することはありません。periodは対象月、released_onは公表元がファイルを最後に更新した日です。未公表の月は欠損のままとし、補完しません。

外貨準備は、オーストラリア（RBAの表A4）、マレーシア（マレーシア国立銀行の総国際準備）、およびECBのユーロ建て準備資産系列を通じてドイツ、フランス、アイルランド、オランダ、ポルトガル、スロベニア、エストニア、ラトビア、リトアニア、クロアチア、チェコで利用できます。チェコの値は、ECBが記録したチェコ国立銀行の数値です。その他の国は404 series_not_foundを返します。

バランスシート

GET /v1/economics/{country}/central-bank/balance-sheetまたはMCPツールeconomics_get_central_bank_balance_sheetで、中央銀行の月次総資産（バランスシート総額）を取得します。任意のperiodに対象月をYYYY-MM形式で指定するか、省略すると最新月のデータを返します。

{
  "country": "CAN",
  "period": "2026-09",
  "value": "242657",
  "currency": "CAD",
  "scale": "millions",
  "released_on": "2026-10-15"
}

periodは対象月で、released_onは公表日を記録します。カナダ銀行のファイルには更新日がないため、カナダのreleased_onにはNarwhalが数値を取得した日を使用します。valueは公表された値をそのまま表す正の10進数の文字列です。currencyとscale（unitsまたはmillions）が銀行の公表単位を示し、Narwhalは換算を行いません。

カナダ（CAN、カナダ銀行、CAD）とマレーシア（MYS、マレーシア中央銀行、MYR）の月次データは、すべてのプランで利用できます。その他の国では404 series_not_foundを返します。明示的に指定したperiodの終了時点がプランの履歴対象期間より前にある場合は、403 plan_upgrade_requiredを返します。Freeは12か月、Basicは5年、Proは全履歴を利用できます。

カバレッジ

ユーロ圏の政策金利は共通です。掲載されている各ユーロ加盟国のコードは、その国のユーロ導入日以降のECB預金ファシリティ金利を返します。

米国、オーストラリア、チェコ、カナダ、マレーシアの行には、金利の決定日（変更時のみ）を記載します。スウェーデン、ノルウェー、デンマーク、ブラジル、ユーロ加盟国の行には、日付付きの観測値を記載し、前回と同じ金利が続く場合もあります。

スウェーデンのpolicy_rateは8 June 2022までレポ金利でした。ブラジルは政策金利のみを対象とし、まだ適用が始まっていない日付は除外されます。

データソースと注意事項

カナダ銀行、ECB、RBAは、各機関のウェブサイトでデータを無料公開しています。Narwhalは形式を変更し、公表された値を返します。これらの機関はNarwhalを推奨していません。

• Source: Bank of Canada. This information is available free of charge on the Bank of Canada website: https://www.bankofcanada.ca.
• Source: European Central Bank (ECB). This information is available free of charge on the ECB website: https://www.ecb.europa.eu.
• Source: Reserve Bank of Australia 2026. This information is available free of charge on the RBA website: https://www.rba.gov.au.

データを表示するすべての場所に出典表記を残してください。リアルタイムデータを取得するページでは、スウェーデン国立銀行の出典表記にデータの日付を記載します。

• Source: Board of Governors of the Federal Reserve System
• Source: Bank Negara Malaysia. Data and information are subject to Terms of Use for BNM Datasets.
• Source: Sveriges Riksbank, with the date of the data.
• Source: the CNB
• Source: Norges Bank
• Source: Danmarks Nationalbank
• Source: Statistics Denmark - StatBank.dk/dnrentd
• Source: Banco Central do Brasil (SGS 432), Open Data Commons Open Database License (ODbL).

利用条件： オーストラリア準備銀行 · チェコ国立銀行 · 連邦準備制度

エラー

• 400 invalid_query 国、日付、またはフィルターが無効です。
• 400 invalid_cursor カーソルの形式が不正か、異なるフィルター用に発行されたカーソルです。
• 401 invalid_api_key Bearerキーがないか、拒否されました。
• 403 plan_upgrade_required 指定日、または指定範囲の終了時点が、プランの履歴範囲より前です。
• 404 series_not_found リクエストに一致する金利がないか、対象国のデータを提供していません。
• 409 cursor_expired カーソルの発行から24時間を超えているか、対象データが撤回されています。
• 429 rate_limit_exceeded 短時間の利用上限に達しました。Retry-Afterで指定された時間を待ってください。
• 429 quota_exhausted アカウントが月間利用枠を使い切っています。
• 503 economics_unavailable データソースのデータを安全に提供できません。

エラーとクォータ · 経済データAPIリファレンス · 中央銀行の政策金利API