一、应用场景
- 外贸：给国外客户报价，一键换算外币价格
- 跨境电商：店铺自动显示美元、欧元等售价
- 公司财务：员工国外出差报销，按当天外币换算人民币做账
- 旅游平台：国外酒店机票，自动换成人民币给国内用户看
- 做小程序 / 网站的开发者：做汇率换算小工具、汇率行情页面
二、接口说明
汇率查询接口包含四个子接口：
✅实时汇率查询换算
✅货币列表
✅单货币列表
✅银行汇率实时查询
汇率行情仅供参考，旨在提供市场动态和信息，不构成任何形式的投资建议。
子接口1：实时汇率查询换算
核心接口，指定源币种、目标币种、金额，直接返回汇率 + 换算结果。
输入「1人民币换成美元」，直接告诉你等于多少美元和汇率。
主要应用于汇率计算器、跨境电商标价、订单结算、支付换算。
请求参数
返回参数
| 名称 | 类型 | 说明 | 示例（1元） |
|---|---|---|---|
| from | string | 转换汇率前的货币代码 | CNY |
| from_name | string | 货币名称 | 人民币 |
| to | string | 转换汇率前的货币代码 | USD |
| to_name | string | 货币名称 | 美元 |
| exchange | string | 当前汇率 | 0.149300 |
| updatetime | string | 更新时间 | 2026-10-09 10:12:01 |
| money | string | 换算后金额 | 0.149300 |
数据来源：探数API
🚨每1分钟会更新一次最新实时汇率，由于公布数据源的延迟，部分货币会有不定滞后时间，以updatetime字段更新为准。
子接口2：货币列表
拿到全部可选货币的目录（代码、中文名称），主要用来做前端下拉选择。
返回参数
| 名称 | 类型 | 说明 | 示例 |
|---|---|---|---|
| list.name | string | 货币名称 | 人民币 |
| list.code | string | 货币代码 | CNY |
💡还可以获取icon图片资源包
子接口3：单货币列表
选定一个基准货币，返回该货币对所有其他币种的实时汇率。以人民币为基准，拿到人民币兑美元、欧元、日元等全部汇率。
主要应用于率行情看板、多币种展示页面、批量获取汇率。
请求参数：输入你需要查询的货币代码，代码可以通过子接口二查询。
返回参数
🚨银行公开的外汇最新实时汇率，每10s更新一次
子接口4：银行汇率实时查询
区别于实时汇率查询换算，该接口返回银行外汇牌价（现汇买入、现钞买入、现汇卖出、现钞卖出、中间价）
通俗理解：去银行柜台换外币的真实价格，有差价。 拿美元现金去银行换人民币，用现钞买入价；拿人民币去银行买美元，用卖出价。
典型场景：用于结汇、购汇、银行牌价展示
请求参数
返回参数
四、Python调用教程
import urllib, urllib3, sys, uuid
import ssl
host = 'https://market.aliyun.com/detail/cmapi00065831'#地址
path = '/list'
method = 'GET'
appcode = '你自己的AppCode'
querys = ''
bodys = {
}
url = host + path
http = urllib3.PoolManager()
headers = {
'Authorization': 'APPCODE ' + appcode
}
response = http.request('GET', url, headers=headers)
content = response.data.decode('utf-8')
if (content):
print(content)
