在做跨境电商、国际结算、外汇展示或多币种报价时，经常需要接入一个稳定的汇率查询接口。本文记录一个实时汇率查询 API 的调用方式，并整理它的返回结构，方便后续在项目中做汇率展示、金额换算、定时同步或数据库入库处理。

这里以汇率查询的子接口中的人民币兑换美元为例，演示如何通过 urllib3 发起请求，并解析返回的汇率数据。

---

1. 接口信息

这个接口用于查询实时汇率和币种转换结果，支持常见外币与人民币之间的换算，也可以用于银行汇率、外汇行情、货币列表等相关场景。

常见使用场景包括：

• 实时汇率查询
• 货币转换
• 外汇行情展示
• 跨境电商金额换算
• 国际结算参考
• 银行汇率查询

---

2. Python 调用示例

下面是一个最基础的调用方式，使用 urllib3 发送 GET 请求：

import urllib3

host = 'https://market.aliyun.com/detail/cmapi00065831'#地址
path = '/index'
url = host + path + '?from=CNY&to=USD&money=1'
appcode = '你自己的AppCode'

http = urllib3.PoolManager()

headers = {
    'Authorization': 'APPCODE ' + appcode
}

response = http.request('GET', url, headers=headers)
content = response.data.decode('utf-8')

if content:
    print(content)

这段代码完成了三件事：

• 拼接请求地址
• 设置认证头
• 发起请求并输出返回结果

如果后续要在业务里使用，建议把返回内容转换成 Python 字典，再做字段读取。

---

3. 返回结果结构

接口返回的 JSON 示例大致如下：

{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "from": "CNY",
    "from_name": "人民币",
    "to": "USD",
    "to_name": "美元",
    "exchange": "0.147096",
    "updatetime": "2026-06-26 17:44:02",
    "money": "0.147096"
  }
}

从结构上看：

• code 表示接口状态
• msg 表示返回信息
• data 是汇率主体数据
• from 是源币种代码
• from_name 是源币种名称
• to 是目标币种代码
• to_name 是目标币种名称
• exchange 是当前汇率
• updatetime 是更新时间
• money 是按输入金额换算后的结果

---

4. 字段含义说明

以 CNY -> USD 为例，字段含义如下：

• from：源货币代码
• from_name：源货币名称
• to：目标货币代码
• to_name：目标货币名称
• exchange：汇率值
• updatetime：更新时间
• money：换算后的金额

例如这段数据：

{
  "from": "CNY",
  "from_name": "人民币",
  "to": "USD",
  "to_name": "美元",
  "exchange": "0.147096",
  "updatetime": "2026-06-26 17:44:02",
  "money": "0.147096"
}

5. 以人民币换美元为例

如果业务只关心 CNY -> USD 的换算，可以直接读取 data 节点里的结果。

示例：

data = result['data']

然后就可以拿到完整的换算信息。
这种方式适用于：

• 汇率卡片展示
• 金额实时换算
• 订单币种转换
• 定时任务写库
• 财务辅助计算