查询兑换记录

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）