中央銀行利率 API

十家中央銀行的政策利率已開放存取,採用統一的資料結構。此央行利率 API 在所有方案中皆提供最新觀測資料與歷史資料,包括 Free,並支援即時存取。REST 路由與 MCP 工具使用相同的政策利率資料結構。

可讀取的資料

涵蓋下列十家中央銀行的官方政策利率。每筆觀測值皆標明國家、主管機關、幣別及利率工具。利率以十進位字串表示,單位為年利率百分比,允許負值。單一值觀測資料包含 rate 與 qualifier;區間資料包含 lower_bound 與 upper_bound。

中央銀行與利率工具

銀行傳入的國家代碼政策工具歷史資料起始時間
歐洲央行任一支援的歐元區成員國代碼存款機制利率1999 年 1 月 1 日,或該成員國較晚採用歐元的日期
聯準會USA聯邦資金目標利率,後改為目標區間2003 年 6 月 25 日
加拿大央行CAN隔夜利率目標2009 年 4 月 21 日
捷克國家銀行CZE兩週附買回利率1995 年 12 月 8 日
馬來西亞國家銀行MYS隔夜政策利率2004
澳洲儲備銀行AUS現金利率目標,包含早期的區間值1990 年 1 月 23 日
瑞典中央銀行SWE政策利率,前稱附買回利率1994 年 6 月 1 日
挪威中央銀行NOR活期存款利率1991 年 1 月 1 日
丹麥國家銀行DNK存款憑證利率1992 年 4 月 1 日
Banco Central do BrasilBRASelic 目標利率1999 年 3 月 5 日

支援的歐元區成員國代碼為 DEU、FRA、IRL、NLD、PRT、SVN、EST、LVA、LTU 及 HRV。各代碼皆回傳相同的 ECB 利率工具,歷史資料則從該成員國採用歐元時開始。請以大寫傳入國家代碼。

取得目前利率

省略 date,即可請求 UTC 今日或之前最新的來源觀測值。生效日期在未來的利率絕不會提前取代目前利率。這些請求說明預定公開的契約。

請求美國政策利率
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate"

USA 示意回應使用已儲存、於 2025 年 12 月 11 日生效的區間範例。加拿大範例展示單一值回應,其數值與日期僅供示意。

USA 區間回應示例
{
  "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"
}
加拿大單一值回應示例
{
  "country": "CAN",
  "authority": "bank_of_canada",
  "currency": "CAD",
  "instrument": "overnight_rate_target",
  "rate_type": "point",
  "rate": "2.00",
  "qualifier": "exact",
  "unit": "percent",
  "observed_on": "2025-12-11"
}

取得過去指定日期的利率

傳入 date=YYYY-MM-DD,即可取得該日或之前最新的觀測值。缺少資料的日期不會補造。每筆觀測資料必定包含 effective_on 或 observed_on 其中一個欄位,也可能包含 announced_on。比較各國或記錄利率變動時,請保留這項區別。

請求指定日期的觀測值
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate?date=2025-12-11"

取得歷史資料

在歷史資料路由使用 start、end 及 limit。預設筆數上限為 100,允許範圍為 1 至 1000。回應包含 country、依時間由舊到新排列的 observations,以及 next_cursor。將回傳的游標作為 cursor 傳入,即可取得下一頁。

請求政策利率歷史資料
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/economics/USA/central-bank/policy-rate/history?start=2025-12-11&end=2026-10-27&limit=100"

游標會固定所用的發布資料,效期為 24 小時。游標過期或資料使用權遭撤回時,會回傳 409。輸入無效時回傳 400,資料無法提供時回傳 404,來源資料不安全時回傳 503。每次請求消耗一個計量單位。錯誤處理方式請參閱錯誤文件。

官方準備資產

預定的準備資產路由為 /v1/economics/{country}/central-bank/reserves,可選擇傳入 period=YYYY-MM。涵蓋 AUS、MYS,以及透過 ECB 序列提供的上述十個歐元區成員國與 CZE。澳洲以 AUD 報告,馬來西亞以 MYR 報告,ECB 序列則以 EUR 報告。回應保留發布時的幣別與 scale,後者為 units 或 millions;數值絕不換算。缺少資料的月份維持缺漏。released_on 為發布機構的檔案更新日期。

來源

Narwhal 將加拿大銀行的資料格式標準化。對 ECB 資料的修改僅限格式。提供的數值與發布時完全相同。不代表獲得任何銀行背書。

  • 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. https://www.bnm.gov.my/terms-of-use-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).

什麼是政策利率?

中央銀行透過設定政策利率來引導短期利率。各銀行採用的利率工具不同:ECB 資料串流提供存款機制利率,美國資料串流則提供聯邦資金目標區間。

中央銀行利率資料免費嗎?

所有方案皆可存取即時資料,包括 Free。每次請求消耗一個計量單位。原始資料可於各央行網站免費取得,但須遵守上述來源條款與聲明。

發布於 。

後續步驟