# 查询兑换记录

### **1. 接口调用：**

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

### **2. 请求参数**

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

### 3.请求参数示例

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

### 4.Postman示例

<figure><img src="https://content.gitbook.com/content/CZbt3X4wpzSYqsOt0CQF/blobs/QdBRmjraJ680LGs1V7v1/%E5%9B%BE%E7%89%87.png" alt=""><figcaption></figcaption></figure>

### 5.返回结果示例

```yaml
{
    "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.返回参数说明

<table><thead><tr><th width="128">字段名称</th><th width="218">字段</th><th width="138">数据类型</th><th width="237">备注</th></tr></thead><tbody><tr><td>订单号</td><td>orderId</td><td>String</td><td>eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a</td></tr><tr><td>存币币种</td><td>depositCoinCode</td><td>String</td><td>eg：ETH</td></tr><tr><td>接收币币种</td><td>receiveCoinCode</td><td>String</td><td>eg：BTC</td></tr><tr><td>存币数量    </td><td>depositCoinAmt</td><td>String</td><td>eg：1</td></tr><tr><td>接收币数量     </td><td>receiveCoinAmt </td><td>String</td><td>eg：0.1</td></tr><tr><td>存币地址</td><td>platformAddr</td><td>String</td><td>eg：123123123-232-1231232</td></tr><tr><td>目标币接收地址</td><td>destinationAddr</td><td>String</td><td>"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY, 如有memo,请讲memo放到地址后，用#分隔，例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"</td></tr><tr><td>退原币的地址</td><td>refundAddr</td><td>String</td><td>"eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后，用#分隔，例如：18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632"</td></tr><tr><td>存币的手续费率</td><td>depositCoinFeeRate</td><td>String</td><td>eg：手续费率</td></tr><tr><td>存币的手续费金额     </td><td>depositCoinFeeAmt</td><td>String</td><td>eg：手续费收取的原币的数量</td></tr><tr><td>退币金额</td><td>refundCoinAmt</td><td>String</td><td>eg: 0.98</td></tr><tr><td>兑换成功交易id</td><td>transactionId</td><td>String</td><td>链上交易id，在兑换完成并已发币之后，该字段才会有值</td></tr><tr><td>兑换失败交易id</td><td>refundDepositTxid</td><td>String</td><td>链上交易id，在兑换失败退币情况下，已退币之后，该字段才会有值</td></tr><tr><td>订单状态</td><td>detailState</td><td>String</td><td>"(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或联系客服提供链接"</td></tr><tr><td>实际兑换得到的币的数量</td><td>dealReceiveCoinAmt</td><td>String</td><td> 实际兑换得到的数量,在兑换未完成时，该值为空字符串</td></tr><tr><td>订单完成时间</td><td>completeTime</td><td>String</td><td>订单发币或退币完成时的时间（UTC+8）</td></tr></tbody></table>