# 查询兑换记录

### **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="/files/McbCGkB0AxCttmvVnjv6" 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-swft.swft.pro/zhong-xin-hua-dui-huan-api-jie-kou/cha-xun-dui-huan-ji-lu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.