查询用户当前持仓
请求地址
GET /ftapi/v1/openPosition
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbolId | STRING | NO | 交易对 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | string | 响应代码 |
| msg | string | 响应消息 |
| success | boolean | 是否成功 |
| data | array | 持仓列表 |
| data.avgEntryPrice | string | 平均开仓价 |
| data.bkrFee | string | 破产手续费 |
| data.closedFee | string | 预计平仓手续费 |
| data.ctime | long | 创建时间 |
| data.deductFeeAmount | string | 抵扣的手续费金额 |
| data.deductFundingAmount | string | 抵扣的资金费用金额 |
| data.deductLossAmount | string | 抵扣的亏损金额 |
| data.entryValue | string | 仓位价值 |
| data.feeAmount | string | 当前仓位产生的手续费 |
| data.feeAssetId | string | 手续费币种 |
| data.frozenFee | string | 冻结手续费 |
| data.fundAmount | string | 资金费用 |
| data.lastPrice | string | 最新成交价 |
| data.lastUpdateTime | long | 仓位最近更新时间 |
| data.leverage | integer | 杠杆倍数 |
| data.liquidPrice | string | 强平价格 |
| data.maintainMargin | string | 维持保证金 |
| data.margin | string | 当前仓位保证金金额 |
| data.marginMode | string | 保证金模式 |
| data.marginRate | string | 保证金率 |
| data.markPrice | string | 标记价格 |
| data.otherClosedFee | string | 其它合约预计平仓手续费 |
| data.otherMaintainMargin | string | 其它合约维持保证金 |
| data.pnl | string | 平仓盈亏 |
| data.posTpSlSize | integer | 仓位层级止盈止损订单数量 |
| data.positionId | string | 仓位 ID |
| data.positionMode | string | 持仓模式 |
| data.profitUnreal | string | 未实现盈亏 |
| data.profitUnrealRate | string | 未实现盈亏率 |
| data.quantity | string | 仓位数量 |
| data.realizedPnl | string | 已实现盈亏 |
| data.side | string | 方向 |
| data.symbolId | string | 合约 ID |
| data.tpSl | object | 止盈止损对象 |
| data.tpSlOrders | array | 止盈止损订单列表 |
| data.tpSlSize | integer | 止盈止损单数量 |
| data.uid | string | 用户 ID |
请求示例
https://openapi.bittap.com/ftapi/v1/openPosition?symbol=BTC-USDT-M响应示例
{
"code": "0",
"data": [
{
"avgEntryPrice": "103869.3", // 平均开仓价(平均持仓价格)
"bkrFee": "20.4967084842771385693", // 破产手续费(爆仓时的手续费)
"closedFee": "21.02090413", // 预计平仓手续费
"ctime": 1762244453000, // 创建时间(时间戳,毫秒)
"deductFeeAmount": "0", // 抵扣的手续费金额(如平台代付)
"deductFundingAmount": "0", // 抵扣的资金费用金额
"deductLossAmount": "0", // 抵扣的亏损金额
"entryValue": "41610.04158", // 仓位价值(即持仓价值)
"feeAmount": "20.80502079", // 当前仓位产生的手续费
"feeAssetId": "USDT", // 手续费币种(如 USDT)
"frozenFee": "21.02090413", // 冻结手续费(尚未结算)
"fundAmount": "0", // 资金费用(Funding Fee)
"lastPrice": "104502.9", // 最新成交价(市场最新价)
"lastUpdateTime": 1762244490921, // 仓位最近更新时间(时间戳)
"leverage": 100, // 杠杆倍数
"liquidPrice": "102849.4", // 强平价格(低于该价格将被强制平仓)
"maintainMargin": "208.0502079", // 维持保证金(维持仓位所需最小保证金)
"margin": "637.12131993", // 当前仓位保证金金额
"marginMode": "ISOLATED", // 保证金模式:ISOLATED(逐仓)/ CROSSED(全仓)
"marginRate": "0.4681638652037805", // 保证金率(保证金与仓位价值比)
"markPrice": "104548.7", // 标记价格(用于计算未实现盈亏)
"otherClosedFee": "0", // 其它合约预计平仓手续费(例如组合仓位)
"otherMaintainMargin": "0", // 其它合约维持保证金
"pnl": "0", // 平仓盈亏(已结算)
"posTpSlSize": 0, // 仓位层级止盈止损订单数量
"positionId": "418184455859925120", // 仓位 ID
"positionMode": "HEDGE", // 持仓模式:HEDGE(对冲)/ ONE_WAY(单向)
"profitUnreal": "272.16764", // 未实现盈亏(当前浮动盈亏)
"profitUnrealRate": "0.6541", // 未实现盈亏率(浮动收益率)
"quantity": "0.4006", // 仓位数量
"realizedPnl": "-20.80502079", // 已实现盈亏(已平仓部分的盈亏)
"side": "BUY", // 方向:BUY(做多) / SELL(做空)
"symbolId": "BTC-USDT-M", // 合约 ID,例如 BTC-USDT 永续合约
"tpSl": null, // 止盈止损对象(未设置则为 null)
"tpSlOrders": [], // 止盈止损订单列表
"tpSlSize": 0, // 止盈止损单数量
"uid": "76957286" // 用户 ID
}
],
"msg": "Request successful",
"success": true
}错误码解释
| 代码 | 描述 |
|---|---|
| 500 | 系统内部错误 |
代码示例
最后更新于: