一、汇率接口全景汇率查询 API 通常提供四个子接口覆盖从币种枚举到银行牌价的完整场景接口路径功能所有货币种类列表/list获取系统支持的所有币种代码和名称实时汇率查询换算/index指定两种货币和金额实时换算单个货币汇率列表/single一次请求获取某币种对所有其他货币的汇率银行汇率实时查询/bank获取指定银行的实时外汇牌价这四个接口组合起来可以满足绝大多数汇率相关的业务需求。二、子接口详解2.1 货币种类列表/list获取系统支持的所有货币代码。适合在系统初始化时调用一次缓存到 Redis前端下拉框的币种选项直接从缓存读取。import urllib3 import json host https://market.aliyun.com/detail/cmapi00065831#地址 path /list appcode 你的AppCode http urllib3.PoolManager() headers { Authorization: APPCODE appcode } response http.request(GET, host path, headersheaders) content json.loads(response.data.decode(utf-8)) if content.get(code) 1: for item in content[data][list]: print(f{item[currency]} - {item[name]})返回的data.list是一个数组每个元素包含currency货币代码和name中文名称。目前支持的币种通常有一百多种。2.2 实时汇率查询换算/index最常用的接口。传入源币种、目标币种和金额直接返回换算结果。querys fromCNYtoUSDmoney100 url host /index ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f汇率: 1 {data[from]} {data[exchange]} {data[to]}) print(f换算结果: {data[money]} {data[to]}) print(f更新时间: {data[updatetime]})参数说明参数必填说明from是源货币代码如 CNYto是目标货币代码如 USDmoney否要换算的金额默认 12.3 单个货币汇率列表/single一次请求可以拿到某个币种对所有其他货币的汇率。适合做人民币对全球主要货币汇率一览的页面避免前端循环请求多个币种对。querys fromCNY url host /single ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f基准货币: {data[currency]} {data[name]}) for code, info in data[list].items(): print(f {code} ({info[name]}): {info[rate]})2.4 银行汇率实时查询/bank查询银行的实时外汇牌价包含汇买、汇卖、钞买、钞卖四个价格。querys bank_codeICBC # 工商银行 url host /bank ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f银行: {data[name]}) print(f发布时间: {data[time]}) for item in data[code_list]: print(f {item[code]} {item[name]}) print(f 汇买: {item[hui_in]} | 汇卖: {item[hui_out]}) print(f 钞买: {item[chao_in]} | 钞卖: {item[chao_out]})银行简码ICBC工商银行、BOC中国银行、CCB建设银行等。字段说明hui_in汇买价——银行买入外汇的价格hui_out汇卖价——银行卖出外汇的价格chao_in现钞买入价chao_out现钞卖出价跨境结算时实际换汇成本用的是 hui_out。三、组合使用场景场景用到的接口海淘商品定价/index 做美元→人民币换算汇率看板/single 批量展示主要货币汇率换汇决策参考/bank 对比不同银行的牌价差价多币种结算/list 获取币种列表 /index 逐对换算四、总结汇率数据在跨境业务里是一个平时感觉不到出问题时很痛的隐性依赖。接入前做好选型评估接入后做好限流、精度和缓存处理日常使用基本不会有太大问题。