Links

查询兑换记录

1. 接口调用:

https://{host}/open/api/queryWithInThreeMonths

2. 请求参数

字段名称
是否数组
字段
数据类型
数据长度
必输项
备注
当前页
N
pageNum
String
10
N
eg:1,默认1
每页显示记录数
N
pageSize
String
10
N
eg:200,默认200

3.请求参数示例

{
"pageNum": "1",
"sign": "40BCDDD328DC87060350624ED858344F6CF28D239FF57B2D269049B57FED8E8D",
"timestamp": 1557658505790,
"channelId": "zml-test"
}

4.Postman示例

5.返回结果示例

{
"data": [
{
"orderId": "8c8cc135-9733-449b-a08b-6dad89f96a7d",
"depositCoinCode": "USDT(HECO)",
"receiveCoinCode": "USDT(BSC)",
"depositCoinAmt": "342",
"receiveCoinAmt": "340.514052",
"receiveSwftAmt": "313.9",
"depositCoinState": "already_confirm",
"platformAddr": "0x7885c588ea05d7831d614d4dee380676bd13c020",
"depositCoinFeeRate": "0.002",
"depositCoinFeeAmt": "0.684",
"swftCoinFeeRate": "0.001",
"orderState": "wait_send",
"refundCoinAmt": "",
"destinationAddr": "0x58Be76e984F22F5E48a1D93DC6e8d1C9FF18b1AD",
"refundAddr": "0xec76477312875f901bfd95bd485d6643e56d653a",
"choiseFeeType": "3",
"detailState": "receive_complete",
"transactionId": "0x4022ca66acc98497ae3c20b0bfbfa3b653451dec2b888da8429abb874a4a13d6",
"refundDepositTxid": "",
"depositTxid": null,
"dealReceiveCoinAmt": "340.804026",
"tradeState": "",
"changeType": "advanced",
"dealFinishTime": "2022-12-29 08:48:30",
"createTime": "2022-12-29 08:47:49",
"completeTime": null,
"timeoutShowPlatformAddr": "",
"chainFee": null,
"depositHashExplore": "",
"receiveHashExplore": "",
"refundHashExplore": "",
"instantRate": "0.995655",
"isDiscount": "",
"kycUrl": "",
"nftUrl": "",
"isNft": "",
"payTokenUrl": "",
"router": null,
"swftReceiveAddr": "",
"swftCoinState": "",
"refundCoinMinerFee": "",
"refundSwftAmt": "",
"swftRefundAddr": ""
},
{
"orderId": "270ecbae-7f5c-4667-9c4c-5208eb14c8c9",
"depositCoinCode": "USDT(BSC)",
"receiveCoinCode": "USDT(TRON)",
"depositCoinAmt": "176.4",
"receiveCoinAmt": "174.983189",
"receiveSwftAmt": "161.9",
"depositCoinState": "already_confirm",
"platformAddr": "0xd82bd5ba852114f747643977f2adcb03b557cc20",
"depositCoinFeeRate": "0.002",
"depositCoinFeeAmt": "0.3528",
"swftCoinFeeRate": "0.001",
"orderState": "wait_send",
"refundCoinAmt": "",
"destinationAddr": "TAKEvWic2cxULySvqAyUzzUVee4pz8wkTr",
"refundAddr": "0x381480C37b623469afd22541f2Df032208C88A2b",
"choiseFeeType": "3",
"detailState": "receive_complete",
"transactionId": "83a36387eb59bdfb4d3609a45ee4fa402214f64cf252771bba1f93a5dde13649",
"refundDepositTxid": "",
"depositTxid": null,
"dealReceiveCoinAmt": "175.78313",
"tradeState": "",
"changeType": "advanced",
"dealFinishTime": "2022-12-29 08:47:10",
"createTime": "2022-12-29 08:46:24",
"completeTime": null,
"timeoutShowPlatformAddr": "",
"chainFee": null,
"depositHashExplore": "",
"receiveHashExplore": "",
"refundHashExplore": "",
"instantRate": "0.991968",
"isDiscount": "",
"kycUrl": "",
"nftUrl": "",
"isNft": "",
"payTokenUrl": "",
"router": null,
"swftReceiveAddr": "",
"swftCoinState": "",
"refundCoinMinerFee": "",
"refundSwftAmt": "",
"swftRefundAddr": ""
},
{
"orderId": "33bf8037-f881-42f3-8fbd-543fd8d6ed5a",
"depositCoinCode": "USDT(HECO)",
"receiveCoinCode": "USDT(BSC)",
"depositCoinAmt": "3011",
"receiveCoinAmt": "3000.180602",
"receiveSwftAmt": "2763.65",
"depositCoinState": "already_confirm",
"platformAddr": "0x2df620b0bb80998783b7d339bf904dd3822a2e9a",
"depositCoinFeeRate": "0.002",
"depositCoinFeeAmt": "6.022",
"swftCoinFeeRate": "0.001",
"orderState": "wait_send",
"refundCoinAmt": "",
"destinationAddr": "0x58Be76e984F22F5E48a1D93DC6e8d1C9FF18b1AD",
"refundAddr": "0xec76477312875f901bfd95bd485d6643e56d653a",
"choiseFeeType": "3",
"detailState": "receive_complete",
"transactionId": "0x1eef88d0678881c0bd12eff60546a30809df5602aea9382bd11bd83fd7188bca",
"refundDepositTxid": "",
"depositTxid": null,
"dealReceiveCoinAmt": "3000.470533",
"tradeState": "",
"changeType": "advanced",
"dealFinishTime": "2022-12-29 08:45:10",
"createTime": "2022-12-29 08:44:18",
"completeTime": null,
"timeoutShowPlatformAddr": "",
"chainFee": null,
"depositHashExplore": "",
"receiveHashExplore": "",
"refundHashExplore": "",
"instantRate": "0.996407",
"isDiscount": "",
"kycUrl": "",
"nftUrl": "",
"isNft": "",
"payTokenUrl": "",
"router": null,
"swftReceiveAddr": "",
"swftCoinState": "",
"refundCoinMinerFee": "",
"refundSwftAmt": "",
"swftRefundAddr": ""
}]
}

6.返回参数说明

字段名称
字段
数据类型
备注
订单号
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)