今日外汇开放 API

免费、无需注册的汇率数据接口。数据每 30 分钟更新一次，覆盖 150+ 币种，来源为各大银行中间价与市场综合牌价。

GET仅支持 GET 请求 · JSONUTF-8 编码 · 免鉴权无需 API Key · 限流15 次/秒

1. 实时汇率：GET /api/rates

以某个基准货币获取全币种汇率快照。

参数	必填	说明
base	否	基准货币代码（3 位字母），默认 USD，如 ?base=CNY

curl "https://www.jinriwaihui.com/api/rates?base=USD"

{
  "base": "USD",
  "date": "2026-10-12",
  "rates": {
    "CNY": 6.7069,
    "EUR": 0.8606,
    "JPY": 147.61,
    "GBP": 0.7475,
    "HKD": 7.7518
    /* ... 共 150+ 币种 */
  }
}

2. 货币换算：GET /api/convert

按当前汇率把任意金额从一种货币换算为另一种货币。

参数	必填	说明
from	是	源货币代码，如 USD
to	是	目标货币代码，如 CNY
amount	否	金额，默认 1，支持小数

curl "https://www.jinriwaihui.com/api/convert?from=USD&to=CNY&amount=100"

{
  "from": "USD",
  "to": "CNY",
  "amount": 100,
  "rate": 6.7069,
  "result": 670.69,
  "date": "2026-10-12"
}

3. 错误处理

参数缺失或非法时返回 HTTP 200 + JSON 错误对象（便于前端统一处理）：

{
  "error": "invalid_base",
  "message": "base must be a valid 3-letter currency code"
}

限流触发时返回 HTTP 200 与 "error":"rate_limited"，请稍后重试。正常业务使用建议每秒不超过 15 次请求。

4. 前端调用示例

const res = await fetch('https://www.jinriwaihui.com/api/convert?from=USD&to=CNY&amount=100');
const data = await res.json();
console.log(data.result); // 670.69

5. 数据说明

汇率数据来源于公开市场综合牌价，每日 24 小时滚动更新（约 30 分钟一次），仅供个人与机构参考，不构成任何交易建议。查看免责声明。