查看成交记录
请求地址
GET /ftapi/v1/tradeHis
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbolId | STRING | NO | 交易对 |
| orderId | LONG | NO | 订单ID |
| startTime | LONG | NO | 开始时间(毫秒) |
| endTime | LONG | NO | 结束时间(毫秒) |
| limit | INT | NO | 返回条数限制,最大值1000 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | string | 响应代码 |
| msg | string | 响应消息 |
| success | boolean | 是否成功 |
| data | array | 成交记录列表 |
| data.dealType | integer | 成交原因 |
| data.deductFeeAmount | string | 抵扣的手续费金额 |
| data.deductLossAmount | string | 抵扣的亏损金额 |
| data.feeAmount | string | 手续费金额 |
| data.feeAssetId | string | 手续费币种 |
| data.leverage | integer | 杠杆倍数 |
| data.liquidityType | integer | 角色类型 |
| data.marginMode | string | 保证金模式 |
| data.markPrice | string | 标记价格 |
| data.orderId | string | 订单 ID |
| data.positionId | string | 持仓 ID |
| data.positionMode | string | 持仓模式 |
| data.profit | string | 盈亏金额 |
| data.side | string | 方向 |
| data.source | integer | 订单来源 |
| data.symbolId | string | 合约符号 |
| data.tradeAmount | string | 成交金额 |
| data.tradeId | string | 成交 ID |
| data.tradePrice | string | 成交价格 |
| data.tradeQuantity | string | 成交数量 |
| data.tradeTime | long | 成交时间 |
| data.tradeType | integer | 成交类型 |
| data.type | string | 订单类型 |
| data.uid | string | 用户 ID |
请求示例
https://openapi.bittap.com/ftapi/v1/tradeHis?symbol=BTC-USDT-M响应示例
{
"code": "0",
"data": [
{
"dealType": 1, // 成交原因:1 - 正常成交,2 - 强平成交,3 - 强平减仓
"deductFeeAmount": "0", // 抵扣的手续费金额
"deductLossAmount": "0", // 抵扣的亏损金额
"feeAmount": "1.016587456", // 手续费金额
"feeAssetId": "USDT", // 手续费币种(例如 USDT)
"leverage": 20, // 杠杆倍数
"liquidityType": 1, // 角色类型:1 - taker(吃单),2 - maker(挂单)
"marginMode": "CROSSED", // 保证金模式:CROSSED(全仓) / ISOLATED(逐仓)
"markPrice": "106410.5", // 标记价格(市价标记)
"orderId": "111429461924122624", // 订单 ID
"positionId": "6017661495600394692", // 持仓 ID
"positionMode": "HEDGE", // 持仓模式:HEDGE(对冲) / ONE_WAY(单向)
"profit": "0", // 盈亏金额
"side": "BUY", // 方向:BUY(买入开多) / SELL(卖出开空)
"source": null, // 订单来源:0/1 - 用户,2 - 强平,10 - 反手
"symbolId": "BTC-USDT-M", // 合约符号(例如 BTC-USDT 永续合约)
"tradeAmount": "10165.87456", // 成交金额
"tradeId": "226920709357568", // 成交 ID
"tradePrice": "106337.6", // 成交价格
"tradeQuantity": "0.0956", // 成交数量
"tradeTime": 1762233378235, // 成交时间(时间戳)
"tradeType": 3, // 成交类型:1 - 开仓,2 - 平仓,3 - 加仓,4 - 减仓
"type": "LIMIT", // 订单类型:LIMIT(限价单) / MARKET(市价单)
"uid": "76957286" // 用户 ID
}
],
"msg": "Request successful",
"success": true
}错误码解释
| 代码 | 描述 |
|---|---|
| 500 | 系统内部错误 |
代码示例
最后更新于: