查询当前持仓

描述

此接口用于查询当前用户持仓仓位的信息。

HTTP请求

GET /v3/trade/position/opens

请求参数

参数	是否必填	类型	描述
symbol	否	String	交易对，若为空，则全量查询当前用户名下所有持仓

响应参数

参数	类型	描述
symbol	String	交易对
side	String	枚举值：BUY, SELL
mgnMode	String	保证金模式；枚举：ISOLATED 逐仓，CROSS 全仓
posSide	String	持仓方向, 买卖模式下默认值BOTH，开平仓模式下： LONG：平多 ，SHORT：平空
openAvgPx	String	开仓均价
qty	String	持仓张数(成交后的仓位数量)
availQty	String	可平张数
lever	String	仓位杠杆倍数，产品形态变更-固定杠杆倍数
adl	String	自动减仓指示(1、2、3、4、5)，1档风险最低，5档风险最高
liqPx	String	预估强平价
im	String	初始保证金
mm	String	维持保证金
mgn	String	逐仓保证金
maxWAmt	String	逐仓最大可提取金额
upl	String	未实现盈亏，按标记价格计算
pnl	String	累计已实现盈亏
uplRatio	String	未实现收益率，按标记价格计算
markPx	String	标记价格
lastPx	String	最新价格
indexPx	String	指数价格
mgnRatio	String	保证金率
state	String	仓位状态；枚举：NORMAL, LIQ, ADL
actType	String	账户类型
tpTrgPx	String	止盈触发价格
slTrgPx	String	止损触发价格
cTime	String	创建时间
uTime	String	更新时间

请求示例

{
    "symbol":"BTC_USDT_PERP"
}

响应示例

{
  "code": 200,
  "data": [
    {
      "adl": "0.1666",
      "availQty": "1",
      "cTime": "1719894977164",
      "im": "1.955006333333333333",
      "lever": "30",
      "liqPx": "0",
      "markPx": "58650.19",
      "lastPx": "58650.19",
      "indexPx": "58650.19",
      "mgn": "1.955006333333333333",
      "mgnMode": "CROSS",
      "maxWAmt": "100000",  
      "posSide": "BOTH",
      "mgnRatio": "0",
      "mm": "0.322576045",
      "openAvgPx": "58651",
      "pnl": "0",
      "qty": "1",
      "side": "BUY",
      "state": "NORMAL",
      "actType": "TRADING", 
      "tpTrgPx": "58670",
      "slTrgPx": "61003",   
      "symbol": "BTC_USDT_PERP",
      "uTime": "1719974554434",
      "upl": "-0.00081",
      "uplRatio": "-0.0004"
    }
  ],
  "msg": "Success"
}