全球汇率查询换算

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

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

前置配置：获取 API Key

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

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

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

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

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

使用方法

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

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

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

查询支持的货币列表

python scripts/exchange_rate.py --list

直接调用 API（无需脚本）

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

# 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

输出示例

人民币对美元汇率

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

💱 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"
}

美元兑人民币并换算金额

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

💱 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"
}

常用货币代码

AI 使用指南

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

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

错误处理

脚本位置

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

关于聚合数据

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

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

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