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

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

请求URL

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

请求限制

参见速率限制详细

请求参数

请求

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

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

响应详情

响应

{
  "code": 1000,
  "message": "Ok",
  "data": [
    {
      "symbol": "BTCUSDT",
      "leverage": "5",
      "timestamp": 1663814313531,
      "current_fee": "5.00409471",
      "open_timestamp": 1662714817820,
      "current_value": "16680.3157",
      "mark_value": "16673.27053207877",
      "mark_price": "93000.50",
      "position_value": "18584.272343943943943944339",
      "position_cross": "3798.397624451826977945",
      "maintenance_margin": "4798.397624451826977945",
      "margin_type":"Isolated",
      "position_mode": "hedge_mode",
      "close_vol": "100",
      "close_avg_price": "20700.7",
      "open_avg_price": "20200",
      "entry_price": "20201",
      "current_amount": "899",
      "unrealized_value": "1903.956643943943943944339",
      "realized_value": "55.049173071454605573",
      "position_type": 2,
      "account": "futures"
    }
  ],
  "trace": "ae96cae5-1f09-4ea5-971e-4474a6724bc8"
}

字段	类型	描述
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	追加到仓位的保证金
maintenance_margin	String	维持保证金
margin_type	String	仓位保证金类型 -`Cross` -`Isolated`
position_mode	String	持仓模式 -`hedge_mode`=双向持仓 -`one_way_mode`=单向持仓
current_amount	String	当前仓位数量
unrealized_value	String	未实现盈亏
realized_value	String	已实现盈亏
position_type	Int	仓位方向 -`1`=开多 -`2`=开空
account	String	交易用户 -`futures`=合约主账号 -`copy_trading`=跟单子账号
timestamp	Long	当前时间戳(ms)