政策利率 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 密钥、数据结构和配额；每个请求计为一次调用。

所有套餐均提供实时政策利率。最新利率不受历史数据范围限制，而带有 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 作为 cursor 发送，并使用相同的筛选条件和条数上限，直到其值为 null。游标在 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 为与发布值完全一致的正数十进制字符串，currency 和 scale（units 或 millions）标明该央行发布数据时使用的单位；Narwhal 从不进行换算。

所有套餐均提供加拿大（CAN，加拿大银行，CAD）和马来西亚（MYS，马来西亚国家银行，MYR）的月度数据；其他所有国家均返回 404 series_not_found。显式指定的 period 若在套餐历史数据范围之前结束，则返回 403 plan_upgrade_required：Free 提供 12 个月，Basic 提供 5 年，Pro 提供全部历史数据。

覆盖范围

欧元区采用统一的政策利率。每个列出的欧元区成员国代码均返回该国采用欧元之日起的 ECB 存款便利利率。

美国、澳大利亚、捷克、加拿大和马来西亚的数据行列出利率决策日期（仅限利率变动）。瑞典、挪威、丹麦、巴西和欧元区成员国的数据行列出带日期的观测值，利率可能与前一次相同。

截至 2022 年 6 月 8 日，瑞典的 policy_rate 为回购利率。巴西仅提供政策利率数据，尚未生效的日期不包含在内。

数据来源与声明

加拿大银行、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