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

# 【Private】Position Channel

Get Position Data

### Pushing Rules

1. User login required
2. After subscribing, then the changes will be pushed
3. 10 seconds timed push

### Request

> Request

```json theme={null}
{
    "action": "subscribe",
    "args":["futures/position"]
}
```

Message Format:

`{"action":"subscribe","args":["<channel>"]}`

* actions: `subscribe`
* channel: Channel name `futures/position`, fixed value

### Response

> Response

```json theme={null}
{
  "group": "futures/position",
  "data": [
    {
      "symbol": "BTCUSDT",
      "hold_volume": "2000",
      "position_type": 1,
      "open_type": 1,
      "frozen_volume": "0",
      "close_volume": "0",
      "hold_avg_price": "19406.2092",
      "close_avg_price": "0",
      "open_avg_price": "19406.2092",
      "liquidate_price": "15621.998406",
      "create_time": 1662692862255,
      "update_time": 1662692862255,
      "position_mode": "hedge_mode"
    }
  ]
}
```

Return data description:

| Field             | Type   | Description                                           |
| ----------------- | ------ | ----------------------------------------------------- |
| symbol            | String | Contract pair (e.g. BTCUSDT)                          |
| hold\_volume      | String | Number of positions                                   |
| position\_type    | Int    | Position type<br />-`1`=long<br />-`2`=short          |
| open\_type        | Int    | Open position type<br />-`1`=isolated<br />-`2`=cross |
| frozen\_volume    | String | Frozen volume                                         |
| close\_volume     | String | Close volume                                          |
| hold\_avg\_price  | String | Average price of a position                           |
| close\_avg\_price | String | Average close price                                   |
| open\_avg\_price  | String | Average opening price                                 |
| liquidate\_price  | String | Liquidation price                                     |
| create\_time      | Long   | Position created timestamp (ms)                       |
| update\_time      | Long   | Position updated timestamp (ms)                       |
| position\_mode    | String | Position mode<br />-`hedge_mode`<br />-`one_way_mode` |