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

# Position

### Topic: position

Push interval: push on update\
Subscribe to position updates.  Updates will be sent only when specific events occur, such as order executions, placements, or cancellations.  Updates will not be triggered by changes in the mark price.

<RequestExample>
  ```bash Subscribed messages theme={null}
  {
    "id": .....
    "cmd": "SUBSCRIBE",
    "params": ["position"]
  }
  ```
</RequestExample>

<ResponseExample>
  ```bash theme={null}
  {
      "topic": "position",
      "ts": 1677814655101,
      "data":
      {
          "positions":
          [
              {
                  "s": "PERP_BTC_USDT"       // symbol
                  "h": "1",                 // holding
                  "plq": "0.0002",          // pending long quantity
                  "psq": "0.0",             // pending short quantity
                  "aop": "0.0",             // average open price
                  "pnl": "-1.55902",        // 24h pnl
                  "roi": "-0.0054"          // 24h pnl % change
                  "fee": "0.218",           // 24h fee
                  "sp": "49000",            // last settle price
                  "mp": "50000",            // mark price
                  "ot": 1677814653001,      // opening time
                  "aq": 1,                  // adl quantile
                  "lv": 10,                 // leverage
                  "m": "ISOLATED",          // margin mode
                  "ps": "BOTH",             // position side
                  "it": "USDT",             // isolated margin token
                  "ia": "1000",             // isolated margin amount
                  "il": "10",               // isolated margin frozen long
                  "is": "10",               // isolated margin frozen short
                  "ver": 93454,             // version
                  "ts": 1677814653001       // timestamp of actual position update
              },
              ...
          ]
      }
  }
  ```
</ResponseExample>