查询仓位详情V2 (KEYED) - WOO X Pro

适用于查询指定合约的仓位详情V2

请求URL

GET https://cloud-api.wooxpro.com/contract/private/position-v2

请求限制

参见速率限制详细

请求参数

请求

curl -H 'X-API-KEY:{{AccessKey}}'
https://cloud-api.wooxpro.com/contract/private/position-v2?symbol=BTCUSDT

参数	类型	是否必填	描述
symbol	String	选填	合约交易对（如BTCUSDT）
account	String	选填	交易用户 -`futures`=合约主账号(默认) -`copy_trading`=跟单子账号

注意

不传symbol，有仓位的交易对才返回数据，没有仓位的交易对不返回数据
传了symbol，不管有没有仓位，都返回数据，如果用户没有仓位，则仓位相关的字段展示0

响应详情

单向持仓模式下：

{
  "code": 1000,
  "message": "Ok",
  "data": [
    {
      "symbol": "BTCUSDT",
      "leverage": "51",
      "timestamp": 1746687390815,
      "current_fee": "0.0000397",
      "open_timestamp": 0,
      "current_value": "0",
      "mark_price": "98952",
      "position_value": "0",
      "position_cross": "0",
      "maintenance_margin": "0",
      "close_vol": "0",
      "close_avg_price": "0",
      "open_avg_price": "0",
      "entry_price": "0",
      "current_amount": "0",
      "position_amount": "5",
      "realized_value": "0",
      "mark_value": "0",
      "account": "futures",
      "open_type": "isolated",
      "position_side": "both",
      "unrealized_pnl": "0",
      "liquidation_price": "0",
      "max_notional_value": "500000",
      "initial_margin": "0"
    }
  ],
  "trace": "37ffeecd-3a6f-494a-8337-5c3a6012abfa"
}

双向持仓模式下：

{
  "code": 1000,
  "message": "Ok",
  "data": [
    {
      "symbol": "BTCUSDT",
      "leverage": "51",
      "timestamp": 1746687096451,
      "current_fee": "0.0000397",
      "open_timestamp": 0,
      "current_value": "0",
      "mark_price": "98911.62032609",
      "position_value": "0",
      "position_cross": "0",
      "maintenance_margin": "0",
      "close_vol": "0",
      "close_avg_price": "0",
      "open_avg_price": "0",
      "entry_price": "0",
      "current_amount": "0",
      "position_amount": "5",
      "realized_value": "0",
      "mark_value": "0",
      "account": "futures",
      "open_type": "isolated",
      "position_side": "long",
      "unrealized_pnl": "0",
      "liquidation_price": "0",
      "max_notional_value": "500000",
      "initial_margin": "0"
    },
    {
      "symbol": "BTCUSDT",
      "leverage": "51",
      "timestamp": 1746687096451,
      "current_fee": "0.0000397",
      "open_timestamp": 0,
      "current_value": "0",
      "mark_price": "98911.62032609",
      "position_value": "0",
      "position_cross": "0",
      "maintenance_margin": "0",
      "close_vol": "0",
      "close_avg_price": "0",
      "open_avg_price": "0",
      "entry_price": "0",
      "current_amount": "0",
      "position_amount": "5",
      "realized_value": "0",
      "mark_value": "0",
      "account": "futures",
      "open_type": "isolated",
      "position_side": "short",
      "unrealized_pnl": "0",
      "liquidation_price": "0",
      "max_notional_value": "500000",
      "initial_margin": "0"
    }
  ],
  "trace": "ab2131db-5827-45ca-a1be-94522510e107"
}

字段	类型	描述
leverage	String	杠杆倍数
symbol	String	合约名称
current_fee	String	当前仓位总费用
open_timestamp	Long	开仓时间戳
current_value	String	最新价格计算的仓位价值
mark_price	String	标记价格
mark_value	String	标记价格计算的仓位价值
position_value	String	持仓均价计算的仓位价值
open_avg_price	String	开仓均价
close_avg_price	String	平仓均价
entry_price	String	持仓均价
close_vol	String	平仓量
position_cross	String	追加到仓位的保证金
initial_margin	String	仓位保证金
maintenance_margin	String	维持保证金
open_type	String	仓位类型 -`cross`=全仓 -`isolated`=逐仓
position_side	String	仓位方向 -`long`=多仓 -`short`=空仓 -`both`=单向仓位
liquidation_price	String	强平价
max_notional_value	String	当前最大可持仓价值
current_amount	String	当前仓位数量
position_amount	String	当前仓位方向数量 -`双向持仓`=正数 -`单向持仓`=正数代表多仓，负数代表空仓
unrealized_pnl	String	未实现盈亏（PNL）
realized_value	String	已实现盈亏
account	String	交易用户 -`futures`=合约主账号 -`copy_trading`=跟单子账号
timestamp	Long	当前时间戳(ms)