十家中央銀行的政策利率已開放存取,採用統一的資料結構。此央行利率 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 Brasil | BRA | Selic 目標利率 | 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 日生效的區間範例。加拿大範例展示單一值回應,其數值與日期僅供示意。
{
"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。每次請求消耗一個計量單位。原始資料可於各央行網站免費取得,但須遵守上述來源條款與聲明。
發布於 。
後續步驟
建立免費金鑰,從自己的程式碼呼叫 API。 取得免費 API 金鑰
