> ## 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-risk`

#### 请求限制

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

#### 请求参数

> 请求

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

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

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "message": "Ok",
  "data": [
    {
      "symbol":"BTCUSDT",
      "position_amt":"1",
      "mark_price":"67957.7",
      "unrealized_profit":"969.6",
      "liquidation_price":"64245",
      "leverage":"20",
      "max_notional_value":"3000000",
      "margin_type":"Isolated",
      "isolated_margin":"3078.51948691",
      "position_side":"Long",
      "notional":"66988.1",
      "update_time":1712390438,
      "account": "futures"
    }
  ],
  "trace": "ae96cae5-1f09-4ea5-971e-4474a6724bc8"
}
```

| 字段                   | 类型     | 描述                                                    |
| :------------------- | :----- | :---------------------------------------------------- |
| symbol               | String | 合约名称                                                  |
| position\_amt        | String | 仓位数量                                                  |
| mark\_price          | String | 标记价格                                                  |
| unrealized\_profit   | String | 未实现盈亏                                                 |
| liquidation\_price   | String | 强平价                                                   |
| leverage             | String | 当前杠杆                                                  |
| max\_notional\_value | String | 当前最大可持仓价值                                             |
| margin\_type         | String | 仓位保证金类型 <br />-`Cross`<br />-`Isolated`               |
| isolated\_margin     | String | 逐仓保证金                                                 |
| position\_side       | String | 仓位方向 <br />-`Long`<br />-`Short`                      |
| notional             | String | 仓位净值                                                  |
| account              | String | 交易用户<br />-`futures`=合约主账号<br />-`copy_trading`=跟单子账号 |
| update\_time         | Long   | 仓位更新时间(ms)                                            |