> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询划转列表 (SIGNED)

`查询合约账户划转记录`

#### 请求URL

`POST https://cloud-api.wooxpro.com/account/v1/transfer-contract-list`

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

```shell theme={null}
curl 
 -H 'X-API-KEY:{{AccessKey}}'
 -H 'X-API-TIMESTAMP:{{currentTime}}'
 -H 'X-API-SIGN:{{SIGN}}' 
 -X POST -d '{
    "currency":"USDT",
    "time_start":1684391137804,
    "time_end":1684392577804,
    "page":1,
    "limit":10,
    "recvWindow":5000
}'
https://cloud-api.wooxpro.com/account/v1/transfer-contract-list
```

| 参数          | 类型     | 是否必填 | 描述                               |
| :---------- | :----- | :--- | :------------------------------- |
| currency    | String | 否    | 币种, 如 `BTC`                      |
| time\_start | Long   | 否    | 起始时间(时间戳，精确到毫秒) 如: 1681701557927 |
| time\_end   | Long   | 否    | 结束时间(时间戳，精确到毫秒) 如: 1681701557927 |
| page        | Int    | 必填   | 第几页，取值范围\[1,10000]               |
| limit       | Int    | 必填   | 每页返回条数，取值范围\[10,100]             |
| recvWindow  | Long   | 否    | 交易时效时间，取值范围(0,60000], 默认：5000 毫秒 |

##### 注意

* 没有填写时间范围`time_start`和`time_end`，则默认展示全部的数据。
* 填写时间范围的话，`time_end` 必须比 `time_start` 的值大。
* 如果只填写了`time_start`，则查询从该时间戳开始时间往后的历史记录。
* 如果只填写了`time_end`，则查询从该时间戳开始时间往前的历史记录。

#### 响应详情

> 响应

```json theme={null}
{
    "message":"OK",
    "code":1000,
    "trace":"82abff12-b9d9-4f66-89ea-3b604c6d84",
    "data":{
        "records":[{
            "transfer_id":"664651258694168576",
            "currency":"USDT",
            "amount":"0.1",
            "type":"contract_to_spot",
            "state":"FINISHED",
            "timestamp":1638631674326
        }]
    }
}
```

| 字段           | 类型     | 描述                                                                     |
| :----------- | :----- | :--------------------------------------------------------------------- |
| transfer\_id | String | 划转ID                                                                   |
| currency     | String | 币种                                                                     |
| amount       | String | 成功划转的金额                                                                |
| type         | String | 划转方向<br />-`spot_to_contract`=现货到合约<br />-`contract_to_spot`=合约到现货     |
| state        | String | 划转结果<br />-`PROCESSING`=等待执行<br />-`FINISHED`=成功划转<br />-`FAILED`=划转失败 |
| timestamp    | Long   | 创建时间戳(ms)                                                              |