Skip to Content

查看成交记录

请求地址

GET /ftapi/v1/tradeHis

请求参数

名称类型是否必须描述
symbolIdSTRINGNO交易对
orderIdLONGNO订单ID
startTimeLONGNO开始时间(毫秒)
endTimeLONGNO结束时间(毫秒)
limitINTNO返回条数限制,最大值1000

响应参数

参数名类型描述
codestring响应代码
msgstring响应消息
successboolean是否成功
dataarray成交记录列表
data.dealTypeinteger成交原因
data.deductFeeAmountstring抵扣的手续费金额
data.deductLossAmountstring抵扣的亏损金额
data.feeAmountstring手续费金额
data.feeAssetIdstring手续费币种
data.leverageinteger杠杆倍数
data.liquidityTypeinteger角色类型
data.marginModestring保证金模式
data.markPricestring标记价格
data.orderIdstring订单 ID
data.positionIdstring持仓 ID
data.positionModestring持仓模式
data.profitstring盈亏金额
data.sidestring方向
data.sourceinteger订单来源
data.symbolIdstring合约符号
data.tradeAmountstring成交金额
data.tradeIdstring成交 ID
data.tradePricestring成交价格
data.tradeQuantitystring成交数量
data.tradeTimelong成交时间
data.tradeTypeinteger成交类型
data.typestring订单类型
data.uidstring用户 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系统内部错误

代码示例

最后更新于: