央行汇率 API
一个 API 获取官方央行汇率:覆盖 31 家央行,包括美联储、欧洲央行、英格兰银行、中国人民银行和斯里兰卡央行,历史数据可追溯至 1999 年。税务、海关、审计与合规开票所需的官方公布汇率。
为什么用官方汇率而不是市场汇率?
实时中间价适合货币换算器和价格展示 — 那是我们核心汇率 API 的用途。但许多国家的税务申报、报关、审计、法定账目和开票规则问的不是市场价,而是要求央行在特定日期发布的官方汇率。这个数字固定、可引用,发布后永不改变。
本 API 提供的正是这些官方汇率表 — 每个响应带有银行自己的发布日期(rate_date),凡是计算而非银行公布的数值都有明确标记。
覆盖的央行
已覆盖 — 点击国家进入其央行的汇率 API。欧元区链接至欧洲央行参考汇率。
实时覆盖 — 此表由 API 所用的同一数据库生成,因此始终与 /api/v1/central-banks 一致:
| 央行 | 国家/地区 | 代码 | 货币数 | 历史起始 | 最新汇率 |
|---|---|---|---|---|---|
| Brazil | bcb | 10 | 2016年1月 | 2026-08-04 | |
| Indonesia | bi | 25 | 2016年1月 | 2026-08-05 | |
| Malaysia | bnm | 27 | 2020年1月 | 2026-08-05 | |
| Canada | boc | 27 | 2017年1月 | 2026-08-04 | |
| United Kingdom | boe | 23 | 2016年1月 | 2026-08-03 | |
| Bank of Israel | Israel | boi | 25 | 1975年6月 | 2026-08-04 |
| Bank of Japan | Japan | boj | 1 | 1998年1月 | 2026-08-03 |
| Russia | cbr | 54 | 2016年1月 | 2026-08-04 | |
| Bulgaria | bnb | 29 | 2016年1月 | 2026-08-04 | |
| Central Bank of Argentina | Argentina | bcra | 36 | 2026年8月 | 2026-08-04 |
| Azerbaijan | cbar | 51 | 2016年1月 | 2026-08-05 | |
| Bahrain | cbb | 33 | 2016年1月 | 2026-08-05 | |
| Bosnia and Herzegovina | cbbh | 18 | 2016年1月 | 2026-08-05 | |
| Kuwait | cbk | 10 | 2008年1月 | 2026-08-05 | |
| Nigeria | cbn | 13 | 2001年12月 | 2026-08-04 | |
| Sri Lanka | cbsl | 55 | 2010年5月 | 2026-08-05 | |
| Türkiye | tcmb | 24 | 2020年1月 | 2026-08-04 | |
| Peru | bcrp | 2 | 2016年1月 | 2026-08-03 | |
| Czech Republic | cnb | 33 | 2016年1月 | 2026-08-04 | |
| Eurozone | ecb | 41 | 1999年1月 | 2026-08-04 | |
| Hong Kong Monetary Authority | Hong Kong | hkma | 22 | 1981年1月 | 2026-07-31 |
| Poland | nbp | 35 | 2016年1月 | 2026-08-05 | |
| Norway | norges | 40 | 2016年1月 | 2026-08-04 | |
| China | pboc | 25 | 2006年1月 | 2026-08-05 | |
| Australia | rba | 20 | 2023年1月 | 2026-08-05 | |
| India | rbi | 6 | 2003年1月 | 2026-08-05 | |
| Reserve Bank of New Zealand | New Zealand | rbnz | 17 | 2018年1月 | 2026-08-05 |
| South African Reserve Bank | South Africa | sarb | 23 | 2000年1月 | 2026-08-05 |
| Sweden | riksbank | 33 | 2016年1月 | 2026-08-04 | |
| Swiss National Bank | Switzerland | snb | 26 | 1914年1月 | 2026-07-31 |
| United States | fed | 22 | 2016年1月 | 2026-07-31 |
更多央行在路线图上,重点是其他服务商忽略的南亚和东南亚央行。需要特定银行?告诉我们 — 请求会让该银行提前排期。
快速开始
与 AllRatesToday 其余部分相同的 API 密钥和认证。用熟悉的 source/target 参数查询货币对:
curl "https://allratestoday.com/api/v1/central-bank/cbsl/latest?source=USD&target=LKR" \
-H "Authorization: Bearer art_live_your_key" 响应:
{
"bank": "cbsl",
"name": "Central Bank of Sri Lanka",
"rate_date": "2026-07-28",
"source": "USD",
"target": "LKR",
"rate": 336.2512,
"rate_type": "indicative",
"derived": false,
"method": "published"
} 或获取银行发布的完整汇率表:
curl "https://allratestoday.com/api/v1/central-bank/ecb/latest" \
-H "Authorization: Bearer art_live_your_key" 付费套餐可查任意历史日期或时间序列 — 例如 6 月 30 日发票应适用的欧洲央行汇率:
curl "https://allratestoday.com/api/v1/central-bank/ecb/2026-06-30?source=USD&target=EUR" \
-H "Authorization: Bearer art_live_your_key" 公布值与推算值 — 始终明确区分
如果银行未直接公布你要的货币对,API 会从银行自己的汇率表推算:倒数,或经银行本币的交叉汇率(例如用欧洲央行的 EUR→USD 和 EUR→JPY 得出 USD→JPY)。每个此类结果都返回 "derived": true 和所用 method — 你始终知道数字是央行公布的还是由公布值计算的。严格合规场景请使用银行公布的货币对;derived 标记让差异一目了然。
周末和假日的行为符合审计师的预期:API 返回最近发布的汇率表及其真实 rate_date 和 published_on_requested_date 标记 — 因为周日适用的官方汇率就是周五的。
各套餐包含什么
- 所有套餐(含免费版):
/central-banks覆盖列表及每家央行的/latest— 完整汇率表或单一货币对 - 付费套餐:任意历史日期(
/{bank}/2026-06-30)和每日时间序列(/{bank}/history,单次最多 5,000 行)
每次央行汇率请求计为一次 API 调用,与核心 API 共用同一月度配额(免费版每月 300 次)— 一个密钥、一个套餐、一张账单。央行汇率每个工作日只变一次,本地缓存当日汇率表能让小配额用很久。
适用场景
- 开票与会计 — 自动套用发票日期的官方汇率
- 税务与海关 — 引用当局要求的确切公布汇率
- 审计与报告 — 可复现的历史汇率表,发布后永不改变
- ERP 集成 — 一个 JSON API,无需抓取央行网站
常见问题
什么是央行汇率 API?
返回央行公布的官方汇率 — 合规规则引用的固定每日基准数字 — 而非实时市场价格的 API。
这与你们的实时汇率 API 有何不同?
核心 API 提供持续波动的实时中间价;本 API 提供银行自己每个工作日发布一次的汇率表。许多工作流两者都需要 — 同一个密钥即可。
能查过去某天(如发票日期)的汇率吗?
能 — 查询任意日期即可得到该行当日的官方汇率表,或单一货币对的每日序列。档案很深:欧洲央行至 1999 年、尼日利亚至 2001 年、印度至 2003 年、斯里兰卡至 2010 年。历史数据在付费套餐;最新汇率表免费。
周末和假日怎么办?
返回最近发布的汇率表及其真实 rate_date — 即非工作日法律上适用的汇率。
能增加更多银行吗?
能 — 覆盖范围持续扩大,按请求排优先级。告诉我们你需要的银行。