央行利率 API

可读取的数据

覆盖下列十家央行的官方政策利率。每条观测记录均标明国家、发布机构、货币和利率工具。利率以十进制字符串表示，单位为年利率百分比，允许负值。单值观测包含 rate 和 qualifier；区间观测包含 lower_bound 和 upper_bound。

央行与利率工具

支持的欧元区成员国代码为 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"

美国响应示例使用已保存的区间示例，生效日期为 11 December 2025。加拿大示例展示单值响应；其中的数值和日期仅作示意。

{
  "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。每次请求消耗一个计量单位。原始数据可在各中央银行网站免费获取，但须遵守上述来源条款和声明。