> ## 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.

# 查询仓位详情 (KEYED)

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

#### 请求URL

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

#### 请求限制

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

#### 请求参数

> 请求

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

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

#### 响应详情

> 响应

```json theme={null}
{
  "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 | 仓位保证金类型 <br />-`Cross`<br />-`Isolated`                 |
| position\_mode      | String | 持仓模式 <br />-`hedge_mode`=双向持仓<br />-`one_way_mode`=单向持仓 |
| current\_amount     | String | 当前仓位数量                                                  |
| unrealized\_value   | String | 未实现盈亏                                                   |
| realized\_value     | String | 已实现盈亏                                                   |
| position\_type      | Int    | 仓位方向<br />-`1`=开多<br />-`2`=开空                          |
| account             | String | 交易用户<br />-`futures`=合约主账号<br />-`copy_trading`=跟单子账号   |
| timestamp           | Long   | 当前时间戳(ms)                                               |