货币汇率计算

接口变更记录

变更版本	变更时间	变更人	变更内容
V1.6.1	2024-03-13	Cass Song	新增接口
资金模块V1.5.0	2024-12-13	Colin Zheng	本地银行出金和国际电汇出金手续费计算取出金限制规则表
资金模块V1.6.0	2025-02-18	Cass Song	返回结果新增baseCurrencyServiceCharge、rateCalculationFormula字段

错误码

code	msg	msg_cn
100004	Exchange rate does not exist	汇率不存在
100005	Operation method does not exist	操作方式不存在
100006	Uuid does not exist or the status is abnormal	uuid不存在或状态异常
100007	Setting item is empty	配置项为空
100008	Parameter error	参数错误
手续费
100601	The fee is greater than the amount incurred	手续费大于发生金额
100602	Service charge miscalculation	手续费计算错误
100603	No such digital currency	无此数字货币

请求结构

通信协议: Http、Https

字符编码: UTF-8

公共参数

https://apifox.com/apidoc/shared-5e679ecb-cbd8-4b2c-bbcb-ab16232fb608/doc-2903487

签名方法

暂无

公共返回结果

https://apifox.com/apidoc/shared-5e679ecb-cbd8-4b2c-bbcb-ab16232fb608/api-126997195

接口描述

请求参数

Body 参数application/json

operationModeId

integer

资金操作方式

必需

sourceCurrency

string

来源币种

必需

sourceAmount

number

来源金额

可选

如需计算目标币种金额，则必填。若不传入值，仅返回汇率。

targetCurrency

string

目标币种

必需

uuid

string

用户id

必需

operator

string

发起人UUID

必需

示例

{
  "operationModeId": 0,
  "sourceCurrency": "string",
  "sourceAmount": 0,
  "targetCurrency": "string",
  "uuid": "string",
  "operator": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

code

integer <int32>

可选

data

object

可选

amount

number

目标金额

必需

入参【sourceAmount】有值，此字段才会参与计算。取整方式：向下截断保留6位小数

rate

number

汇率

必需

serviceCharge

number

手续费

必需

取款业务入参【sourceAmount】有值，此字段才会参与计算

isFreeServiceCharge

number

免手续费(默认未免: 0 免:1)

可选

取款业务入参【sourceAmount】有值，此字段才会参与计算

rateCalculationFormula

enum<string>

汇率计算方式

必需

枚举值:

justoppositeconversion

baseCurrencyServiceCharge

number

本位币手续费

必需

msg

string

可选

success

boolean

可选

traceId

string

可选

示例

{
  "code": 0,
  "data": {
    "amount": 16,
    "rate": 50,
    "serviceCharge": 17,
    "isFreeServiceCharge": 78,
    "rateCalculationFormula": "just",
    "baseCurrencyServiceCharge": 78
  },
  "msg": "success",
  "success": true,
  "traceId": "xxxxxxxxxxxxxxxxxxxxxxxxxx"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

⚪110018操作方式不存在

接口变更记录#

错误码#

请求结构#

公共参数#

签名方法#

公共返回结果#

接口描述#

请求参数

示例代码

返回响应

接口变更记录

错误码

请求结构

公共参数

签名方法

公共返回结果

接口描述