前言

汇率换算（Currency Conversion）是指将一种货币的价值转换为另一种货币价值的过程。它是国际贸易、旅游、投资和金融交易中的基础操作。
在金融系统常用到汇率换算功能，
用于国际结算、银行汇率查询应用、开展跨国贸易、投资等参考场景。集成汇率换算API可实现实时汇率转换和汇率查询功能。

汇率换算API有以下特点：

• 支持全球一百多种货币实时汇率换算和汇率查询。
• 数据每分钟更新。

实时汇率转换

币种间的汇率转换。

请求参数

参见接口文档
(https://marketplace.huaweicloud.com/contents/5cd68d0a-25c3-4128-a46c-4c8c368bee5d#productid=OFFI1061188906845941760)
（https://m.ydkja.cn/SbBJwLn）

成功返回样例

{
   
  "code": 200,//返回码，详见code返回码说明
  "msg": "成功",//code对应的描述
  "charge": true,//计费标志
  "taskNo": "825091389158520001104287",//本次唯一请求号
  "data": {
   
    "money": "120.043880",//换算后金额
    "to_name": "欧元",//目标货币名称
    "from": "GBP",//源货币类型
    "exchange": "1.199000",//当前汇率
    "to": "EUR",//目标货币类型
    "from_name": "英镑",//源货币名称
    "updatetime": "2024-10-29 14:00:04" //更新时间
  }
}

失败返回样例

{
   
  "msg": "源货币类型不能为空",
  "code": 400
}

汇率查询

根据货币查询其汇率

请求参数

参见接口文档

成功返回样例

{
   
  "code": 200, //返回码，详见code返回码说明
  "msg": "成功", //code对应的描述
  "charge": true, //计费标志
  "taskNo": "825091389158520001104287", //本次唯一请求号
  "data": {
   
    "name": "英镑", //货币名称
    "currency": "GBP", //货币代码
    "toData": {
   //参数toCode对应的汇率信息
      "rate": "1.293100",
      "name": "美元",
      "updatetime": "2025-04-01 17:25:06"
    },
    "list": {
   
      "FJD": {
   
        "rate": "2.946800", //汇率
        "name": "斐济元", //目标货币名称
        "updatetime": "2024-10-29 04:37:55" //更新时间
      },
      "MXN": {
   
        "rate": "25.949600",
        "name": "墨西哥比索",
        "updatetime": "2024-10-29 13:54:37"
      }
    }
  }
}

失败返回样例

{
   
  "msg": "源货币类型不能为空",
  "code": 400
}

附录

货币代码表