> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询仓位详情V2 (KEYED)

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

#### 请求URL

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

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

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

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

##### 注意

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

#### 响应详情

> 单向持仓模式下：

```json theme={null}
{
  "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"
}
```

> 双向持仓模式下：

```json theme={null}
{
  "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 | 仓位类型<br />-`cross`=全仓<br />-`isolated`=逐仓               |   |
| position\_side       | String | 仓位方向<br />-`long`=多仓<br />-`short`=空仓<br />-`both`=单向仓位 |   |
| liquidation\_price   | String | 强平价                                                     |   |
| max\_notional\_value | String | 当前最大可持仓价值                                               |   |
| current\_amount      | String | 当前仓位数量                                                  |   |
| position\_amount     | String | 当前仓位方向数量<br />-`双向持仓`=正数<br />-`单向持仓`=正数代表多仓，负数代表空仓     |   |
| unrealized\_pnl      | String | 未实现盈亏（PNL）                                              |   |
| realized\_value      | String | 已实现盈亏                                                   |   |
| account              | String | 交易用户<br />-`futures`=合约主账号<br />-`copy_trading`=跟单子账号   |   |
| timestamp            | Long   | 当前时间戳(ms)                                               |   |