◻️创建订单

1. 接口调用：

https://{host}/api/v2/accountExchange

2. 请求参数示例

参数	是否必须	说明
depositCoinCode	是	eg：ETH
receiveCoinCode	是	eg：BTC
depositCoinAmt	是	eg：0.01
receiveCoinAmt	是	期待接收数量
destinationAddr	是	eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请将memo放到地址后，用#分隔 例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632
refundAddr	是	eg：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请将memo放到地址后，用#分隔 例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632
equipmentNo	是	设备唯一编号（序列号），如果无法获取到，可以填写退币地址。该字段在查询订单状态和查询订单记录接口中会用到，需要对应当前下单的查询
sourceType	是	只能填写ANDROID或IOS或H5，请根据自己应用填写，该字段在查询订单状态和查询订单记录接口中会用到
sourceFlag	是	用于标识是哪个平台创建的订单，请联系我们沟通
slippage	否	滑点 输入小数 (系统默认0.05) 0.01 = 1%

3.请求参数示例

{
    "depositCoinCode": "ETHF",
    "receiveCoinCode": "USDT(BSC)",
    "depositCoinAmt": "42.207403",
    "receiveCoinAmt": "46.367529",
    "destinationAddr": "0x19b9918f...f85ad08ba0",
    "refundAddr": "0x19b9918f...f85ad08ba0",
    "equipmentNo":"zfgryh918f93a19fdg6918a68cf5",
    "sourceType": "H5",
    "sourceFlag":"widget",
    "slippage": "0.02"
}

4.返回结果示例

{
    "data": {
        "chainFee": "0.001",//兑换完成后发币旷工费
        "createTime": "2022-03-10 18:44:21",
        "dealFinishTime": null,
        "depositCoinAmt": "2",
        "depositCoinCode": "ETH",
        "depositCoinFeeAmt": "0.004",//兑换手续费
        "depositCoinFeeRate": "0.002",//兑换手续费率
        "depositCoinState": "wait_send",
        "depositFeeRate": "0.002",
        "depositTxid": "",
        "destinationAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//用户接收币种地址
        "detailState": "wait_deposit_send",//订单状态（详见高级兑换接口）
        "instantRate": "6.856554564172",//汇率
        "kycUrl": "",//超过当日限额的kyc路径（详见高级兑换接口）
        "orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",//订单号
        "orderState": "wait_deposits",
        "platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",//存币地址（用户创建订单后需向此地址转币，转币币种depositCoinCode，转币数量depositCoinAmt）
        "receiveCoinAmt": "13.713109",
        "receiveCoinCode": "BNB(BSC)",
        "refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//退币地址（兑换失败退回存币币种到此地址）
        "refundCoinAmt": "",//兑换失败时的退币数量
        "refundDepositTxid": "",//兑换失败时的退币哈希
        "transactionId": "",//发币哈希
    },
    "resCode": "800",
    "resMsg": "成功",
    "resMsgEn": ""
}

5.返回参数说明

字段名称	字段	备注
订单号	orderId	eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a
存币币种	depositCoinCode	eg：ETH
接收币币种	receiveCoinCode	eg：BTC
存币数量	depositCoinAmt	eg：1
接收币数量	receiveCoinAmt	eg：0.1
存币地址	platformAddr	eg：123123123-232-1231232
目标币接收地址	destinationAddr	eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请将memo放到地址后，用#分隔 例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632
退原币的地址	refundAddr	eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请将memo放到地址后，用#分隔 例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632
存币的手续费率	depositCoinFeeRate	eg：手续费率
存币的手续费金额	depositCoinFeeAmt	eg：手续费收取的原币的数量
退币金额	refundCoinAmt	eg: 0.98
兑换成功交易id	transactionId	链上交易id，在兑换完成并已发币之后，该字段才会有值
兑换失败交易id	refundDepositTxid	链上交易id，在兑换失败退币情况下，已退币之后，该字段才会有值
订单状态	detailState	(1)wait_deposit_send:等待存币发送 (2)timeout:超时 (3)wait_exchange_push:等待交换信息推送(4)wait_exchange_return:等待交换信息返回 (5.1) wait_receive_send:等待接收币种发送 wait_receive_confirm:等待接收币种确认 receive_complete:接收币种确认完成 (5.2) wait_refund_send:等待退原币币种发送wait_refund_confirm:等待退原币币种确认 refund_complete:退原币币种确认完成 (6)ERROR/error:正在处理的订单 (7)WAIT_KYC: 等待进行KYC或联系客服提供链接
kyc的路径	kycUrl	当返回码是311时,需要跳转到该链接。 {host}/swft-v3/swft-v3-m/kyc/kyc.html?lang=cn&equipmentNo=pls_input_your_real_equipmentno_ok 请更新equipmentNo的值用户的设备号（公共请求参数），lang取值：cn、en

6.Postman示例