创建订单

1. 接口调用：

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

2. 请求参数实例

参数

是否必须

说明

3.请求参数示例

{
    "depositCoinCode": "ETHF",

    "receiveCoinCode": "USDT(BSC)",
    
"depositCoinAmt": "42.207403",
    
"receiveCoinAmt": "46.367529",

    "destinationAddr": "0x19b9918f...f85ad08ba0",

    "refundAddr": "0x19b9918f...f85ad08ba0",
    
"equipmentNo":"zfgryh918f93a19fdg6918a68cf5",

    "sourceType": "H5",

    "sourceFlag":"widget",
    "isNoGas":true,
    "slippage": "0.02"


}

4.返回结果示例

{
    "data": {
        "chainFee": "0.001",//兑换完成后发币旷工费
        "changeType": "advanced",//去中心化兑换
        "choiseFeeType": "3",
        "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",//订单状态（详见高级兑换接口）
        "developerId": "",
        "instantRate": "6.856554564172",//汇率
        "isDiscount": "N",
        "kycUrl": "",//超过当日限额的kyc路径（详见高级兑换接口）
        "orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",//订单号
        "orderState": "wait_deposits",
        "platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",//存币地址（用户创建订单后需向此地址转币，转币币种depositCoinCode，转币数量depositCoinAmt）
        "receiveCoinAmt": "13.713109",
        "receiveCoinCode": "BNB(BSC)",
        "refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//退币地址（兑换失败退回存币币种到此地址）
        "refundCoinAmt": "",//兑换失败时的退币数量
        "refundCoinMinerFee": "",
        "refundDepositTxid": "",//兑换失败时的退币哈希
        "transactionId": "",//发币哈希
        "xrpInfo": "",
        //开启免 gas 后返回的代签名交易数据
        "noGasTxInfo": "{\"gasLimit\":37920,\"data\":\"0xxxxx\",\"chainId\":56,\"to\":\"0xxxxx\",\"nonce\":51,\"gasPrice\":\"3150000000\"}",
    
    },
    "resCode": "800",
    "resMsg": "成功",
    "resMsgEn": ""
}

5.返回参数说明

6.Postman示例

7. 关于BTC兑换的注意事项

7.1. 默认api并不支持BTC兑换，请联系我们开通渠道白名单api才支持BTC兑换。支持后，创建订单接口将会新返回字段：btcMemo，该字段值为链上转账BTC时需要携带该值。客户端对接BTC兑换需要集成到钱包中，memo以OP_RETURN的形式携带上链（链上形式请见7.3）。如果未携带memo，直接将BTC转入我们的地址，将无法完成兑换。

7.2. memo举例说明：以0.1BTC->USDT(BSC)为例，返回的memo为： "btcMemo":"to:USDT(BSC):0x242Ea2A8C4a3377A738ed8a0d8cC0Fe8B4D6C36E" 拼接方式：to:币种:地址

7.3 BTC兑换后需手动上传存币hash,详情请见(上传hash接口)

7.4. 链上hash示例: https://mempool.space/tx/e8a7259a335e8488005b72dab98dd3087d52e0a94842d2d1a81262ebf8c3ef51

Previous获取兑换汇率 Next上传交易hash

Last updated 3 months ago

参数

是否必须

说明

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

{ "data": { "chainFee": "0.001",//兑换完成后发币旷工费 "changeType": "advanced",//去中心化兑换 "choiseFeeType": "3", "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",//订单状态（详见高级兑换接口） "developerId": "", "instantRate": "6.856554564172",//汇率 "isDiscount": "N", "kycUrl": "",//超过当日限额的kyc路径（详见高级兑换接口） "orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",//订单号 "orderState": "wait_deposits", "platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",//存币地址（用户创建订单后需向此地址转币，转币币种depositCoinCode，转币数量depositCoinAmt） "receiveCoinAmt": "13.713109", "receiveCoinCode": "BNB(BSC)", "refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//退币地址（兑换失败退回存币币种到此地址） "refundCoinAmt": "",//兑换失败时的退币数量 "refundCoinMinerFee": "", "refundDepositTxid": "",//兑换失败时的退币哈希 "transactionId": "",//发币哈希 "xrpInfo": "", //开启免 gas 后返回的代签名交易数据 "noGasTxInfo": "{\"gasLimit\":37920,\"data\":\"0xxxxx\",\"chainId\":56,\"to\":\"0xxxxx\",\"nonce\":51,\"gasPrice\":\"3150000000\"}", }, "resCode": "800", "resMsg": "成功", "resMsgEn": "" }

字段名称

字段

数据类型