Links

批量查询订单状态

1. 接口调用:
https://{host}/api/v2/batchQueryOrderState
2. 请求参数实例
参数
是否必须
说明
orderIds
json数组 最大限制200条

3.请求参数示例

{
"orderIds": [ //最大限制200条订单号 超出限制只会截取前200条数据
"655bce95-577e-4930-bb9e-3f82bc6e57e7",
"33120af8-1866-4cb6-99a8-2c303f490c2c",
"de746e9c-4e6a-4615-8413-6b224fac439e",
"9b8ccde9-fd8f-4014-a77b-ed757a3bb25a",
"2f2e219f-c7af-4fc3-ad01-973a5f10d293",
"edeafba6-e493-4b7f-9203-71484e444d94"
]
}

4.返回结果示例

{
"data": {
"chainFee": "0.001",//兑换完成后发币旷工费
"changeType": "advanced",//去中心化兑换
"choiseFeeType": "3", // 手续费类型
"completeTime": null,
"createTime": "2022-03-10 18:44:21",
"dealFinishTime": null,
"dealReceiveCoinAmt": "",
"depositCoinAmt": "2",
"depositCoinCode": "ETH",
"depositCoinFeeAmt": "0.004",//兑换手续费
"depositCoinFeeRate": "0.002",//兑换手续费率
"depositCoinState": "wait_send",
"depositHashExplore": "https://etherscan.io/tx/null", //存币hash
"depositTxid": "",
"destinationAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//用户接收币种地址
"detailState": "wait_deposit_send",//订单状态(详见查询订单状态接口)
"instantRate": "6.874588522739",//汇率
"isDiscount": "N",
"isNft": "",
"kycUrl": "",//超过当日限额的kyc路径(详见查询订单状态接口)
"nftUrl": "",
"orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94",//订单号
"payTokenUrl": "",
"platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8",//存币地址(用户创建订单后需向此地址转币,转币币种depositCoinCode,转币数量depositCoinAmt)
"receiveCoinAmt": "13.713109",
"receiveCoinCode": "BNB(BSC)",
"receiveHashExplore": "https://bscscan.com/tx/",
"receiveSwftAmt": "2416.89",
"refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071",//退币地址(兑换失败退回存币币种到此地址)
"refundCoinAmt": "",//兑换失败时的退币数量
"refundCoinMinerFee": "",
"refundDepositTxid": "",//兑换失败时的退币哈希
"refundHashExplore": "https://etherscan.io/tx/",
"refundSwftAmt": "",
"router": {},
"swftCoinFeeRate": "0.001",
"swftCoinState": "",
"swftReceiveAddr": "",
"swftRefundAddr": "",
"timeoutShowPlatformAddr": "N", // 是否展示复用地址
"tradeState": "",
"transactionId": "",//兑换完成的发币哈希
"burnRate": "0",//燃烧率
"refundReason": "" // 退币原因
},
"resCode": "800",
"resMsg": "成功",
"resMsgEn": ""
}

5.返回参数说明

字段名称
字段
数据类型
备注
订单号
orderId
String
eg:d47e8b9b-c17f-432b-9285-a46c0a3ceb9a
存币币种
depositCoinCode
String
eg:ETH
接收币币种
receiveCoinCode
String
eg:BTC
存币数量
depositCoinAmt
String
eg:1
接收币数量
receiveCoinAmt
String
eg:0.1
存币地址
platformAddr
String
eg:123123123-232-1231232
目标币接收地址
destinationAddr
String
"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY, 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"
退原币的地址
refundAddr
String
"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"
存币的手续费率
depositCoinFeeRate
String
eg:手续费率
存币的手续费金额
depositCoinFeeAmt
String
eg:手续费收取的原币的数量
退币金额
refundCoinAmt
String
eg: 0.98
兑换成功交易id
transactionId
String
链上交易id,在兑换完成并已发币之后,该字段才会有值
兑换失败交易id
refundDepositTxid
String
链上交易id,在兑换失败退币情况下,已退币之后,该字段才会有值
订单状态
detailState
String
"(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或联系客服提供链接"
实际兑换得到的币的数量
dealReceiveCoinAmt
String
实际兑换得到的数量,在兑换未完成时,该值为空字符串
订单完成时间
completeTime
String
订单发币或退币完成时的时间(UTC+8)
燃烧率
burnRate
String
燃烧率 默认为0
订单创建时间
createTime
String
订单创建时间
订单完成的时间
dealFinishTime
String
订单完成的时间
存币的存放状态
depositCoinState
String
wait_send:待发送、wait_confirm:待确认、already_confirm:已确认
退手续费交易id
depositTxid
String
退手续费交易id
速币数量
receiveSwftAmt
String
速币数量
速币的手续费率
swftCoinFeeRate
String
速币的手续费率
兑换成功发币矿工费
chainFee
String
兑换成功发币矿工费
兑换类型
changeType
String
兑换类型
超过当日限额kyc路径
kycUrl
String
超过当日限额kyc路径
退币原因
refundReason
String
返回数字 对应下方信息 1 流动性不足(默认) 2 误差超过阈值 3 kyc超额 4 地址黑名单 5 目标币维护
6 兑换数量不在范围内 7 存币超时