适用于查询合约资金流水记录
请求URL
GET https://cloud-api.wooxpro.com/contract/private/transaction-history
请求限制
参见 速率限制详细请求参数
请求
curl -H 'X-API-KEY:{{AccessKey}}'
https://cloud-api.wooxpro.com/contract/private/transaction-history?symbol=BTCUSDT&start_time=1662368173000&end_time=1662368179000
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | String | 选填 | 交易对 |
| flow_type | Int | 选填 | 类型 - 0 = 全部(默认) - 1 = 划转 - 2 = 已实现盈亏 - 3 = 资金费用 - 4 = 手续费 - 5 = 强平清算费 |
| account | String | 选填 | 交易用户 - futures=合约主账号- copy_trading=跟单子账号 |
| start_time | Long | 选填 | 开始时间(时间戳,精确到毫秒) |
| end_time | Long | 选填 | 结束时间(时间戳,精确到毫秒) |
| page_size | Int | 选填 | 每页返回的记录数,默认100,最大1000 |
注意
- 如果
start_time和end_time均未发送, 只会返回最近7天的数据。 - 如果
type没有发送,返回所有类型账户损益资金流水。
响应详情
响应
{
"code": 1000,
"message": "Ok",
"data": [
{
"symbol": "",
"type": "Transfer",
"amount": "-0.37500000",
"asset": "USDT",
"account": "futures",
"time": "1570608000000",
"tran_id": "9689322392"
},
{
"symbol": "BTCUSDT",
"type": "Commission Fee",
"amount": "-0.01000000",
"asset": "USDT",
"account": "futures",
"time": "1570636800000",
"tran_id": "9689322392"
}
],
"trace": "80ba1f07-1b6f-46ad-81dd-78ac7e9bbccd"
}
| 字段 | 类型 | 描述 |
|---|---|---|
| symbol | String | 交易对 |
| flow_type | Int | 类型 - 0 = 全部(默认) - 1 = 划转 - 2 = 已实现盈亏 - 3 = 资金费用 - 4 = 手续费 - 5 = 强平清算费 |
| type | STRING | 类型 - Transfer - Realized PNL - Funding Fee - Commission Fee - Liquidation Clearance |
| account | String | 交易用户 - futures=合约主账号- copy_trading=跟单子账号 |
| amount | String | 金额,支持正负号 |
| asset | String | 资金流水币种 |
| time | String | 交易时间戳(ms) |
| tran_id | String | 交易ID |