全球汇率查询换算#

数据由 聚合数据 提供 — 根据货币代码查询汇率和换算，支持全球 120+ 个国家和地区货币。数据来源于网络，仅供参考，交易时以银行柜台成交价为准。

根据 官方文档，API 80 提供两个接口： 货币列表、 实时汇率查询换算。

---

前置配置：获取 API Key#

1. 前往 聚合数据官网 免费注册账号
2. 进入 全球汇率查询换算 API 页面，点击「申请使用」
3. 审核通过后在「我的API」中获取 AppKey
4. 配置 Key（ 三选一）：

bash

# 方式一：环境变量（推荐）
export JUHE_EXCHANGE_KEY=你的AppKey

# 方式二：.env 文件
echo "JUHE_EXCHANGE_KEY=你的AppKey" > scripts/.env

# 方式三：命令行传入
python scripts/exchange_rate.py --key 你的AppKey --from USD --to CNY

计费说明：该接口为订阅付费，具体免费额度以聚合数据后台为准。

---

使用方法#

查询两种货币的汇率并换算#

bash

# 查询 USD 兑 CNY 汇率
python scripts/exchange_rate.py --from USD --to CNY

# 换算 100 美元等于多少人民币
python scripts/exchange_rate.py --from USD --to CNY --amount 100

查询支持的货币列表#

bash

python scripts/exchange_rate.py --list

直接调用 API（无需脚本）#

官方文档仅包含以下两个接口：

text

# 1. 货币列表
GET http://op.juhe.cn/onebox/exchange/list?key=YOUR_KEY

# 2. 实时汇率查询换算
GET http://op.juhe.cn/onebox/exchange/currency?key=YOUR_KEY&from=USD&to=CNY

---

输出示例#

人民币对美元汇率#

bash

$ python scripts/exchange_rate.py --from CNY --to USD

text

💱 CNY → USD
   汇率: 1 CNY = 0.145055 USD
   更新: 2026-03-24 10:36:37

{
  "success": true,
  "data": {
    "currencyF": "CNY",
    "currencyF_Name": "人民币",
    "currencyT": "USD",
    "currencyT_Name": "美元",
    "currencyFD": "1",
    "exchange": "0.14505500",
    "result": "0.14505500",
    "updateTime": "2026-03-24 10:36:37"
  },
  "rate": 0.145055,
  "updateTime": "2026-03-24 10:36:37"
}

美元兑人民币并换算金额#

bash

$ python scripts/exchange_rate.py --from USD --to CNY --amount 100

text

💱 USD → CNY
   汇率: 1 USD = 6.894 CNY
   更新: 2026-03-24 10:36:37
   换算: 100.0 USD = 689.4 CNY

{
  "success": true,
  "data": {
    "currencyF": "USD",
    "currencyF_Name": "美元",
    "currencyT": "CNY",
    "currencyT_Name": "人民币",
    "currencyFD": "1",
    "exchange": "6.89400000",
    "result": "6.89400000",
    "updateTime": "2026-03-24 10:36:37"
  },
  "rate": 6.894,
  "updateTime": "2026-03-24 10:36:37"
}

---

常用货币代码#

代码货币CNY人民币USD美元EUR欧元JPY日元GBP英镑HKD港币AUD澳元CAD加元KRW韩元SGD新加坡元

---

AI 使用指南#

当用户询问汇率或货币换算时，按以下步骤操作：

1. 识别意图 — 查两种货币汇率、换算金额，或查货币列表
2. 提取货币代码 — 从用户消息提取（如「美元」→ USD，「人民币」→ CNY）
3. 提取金额 — 若有「100 美元」「5000 日元」等，提取数值
4. 调用脚本或 API — 执行查询
5. 展示结果 — 清晰呈现汇率和换算结果

错误处理#

情况处理方式208001货币兑换名称不能为空，需提供 from 和 to208002/208004/208006查询不到汇率，检查货币代码是否正确208005不存在的货币种类10001/10002API Key 无效，引导用户至 聚合数据 重新申请10012请求超过次数限制，建议升级套餐

---

脚本位置#

scripts/exchange_rate.py — 封装货币列表、实时汇率换算和错误处理。

---

关于聚合数据#

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供：

• 金融数据：汇率、油价、股票、黄金
• 生活服务：天气、新闻、快递
• 身份核验：手机归属地、身份证验证

注册即可使用，适合个人开发者和企业接入。