# Positions

> Request append param

| name | type   | required | detail |
| ---- | ------ | -------- | ------ |
| pair | String | √        |        |

```
{
  "pair": "ETH-USD",
  "method": "SUBSCRIBE",
  "apiKey": "?",
    "signType": 2,
  "signature": "?",
  "event": "api_position",
  "timestamp": 1657157345159
}
```

> Receive data:

| name    | type    | required | detail        |
| ------- | ------- | -------- | ------------- |
| data    | Object  |          | position info |
| event   | String  |          | api\_position |
| success | Boolean |          | true,false    |

data object:

| name              | type    | required | detail                                  |
| ----------------- | ------- | -------- | --------------------------------------- |
| changeType        | String  |          | NEW/ INCREASE/ CLOSE/LIQUIDATE/ REDUCE; |
| currentQuantity   | String  |          |                                         |
| direction         | String  |          | LONG/SHORT                              |
| operateQuantity   | String  |          |                                         |
| positionId        | Long    |          | ID                                      |
| symbol            | String  |          |                                         |
| canClosedQuantity | String  |          |                                         |
| contractPairId    | Long    |          |                                         |
| positionType      | Integer |          | 3 one-way isloate 4 one-way cross       |
| openingPrice      | String  |          |                                         |
| marginAmount      | String  |          | Initial margin amount                   |
| marginCallAmount  | String  |          |                                         |

Example:

> 1 Get current timestamp(ms):

```
1725870816532
```

> 2 Sign the string format of the timestamp, result:

```
0xc2a5c5ac88017831c64176d3c0ab0c6275c5c51c7fe496925aa48c7c5c894c431e22d7d94adf7fc0215b8a636bd90f6b0909bc9923f425918740443af2e593b11b
```

> 3 Assembling parameters, including basic parameters for subscription and custom additional parameters for the interface.

```
{
    "pair": "ETH-USD",
    "method": "SUBSCRIBE",
    "event": "api_position",
    "apiKey": "st_fq6cvRF4fr5tnKiZfrIntRnLfrwxcXjcfr1y8FR7",
    "signature": "0xc2a5c5ac88017831c64176d3c0ab0c6275c5c51c7fe496925aa48c7c5c894c431e22d7d94adf7fc0215b8a636bd90f6b0909bc9923f425918740443af2e593b11b",
    "timestamp": 1725870816532,
    "signType": "2"
}
```

> 4 Returns after a successful subscription

```
{
    "event": "api_position_res",
    "method": "SUBSCRIBE",
    "msg": "subscribe success: api_position",
    "pair": "ETH-USD",
    "success": true
}
```

> 5 Server websocket push data.

```
{
    "data": {
        "canClosedQuantity": "0.06",
        "changeType": "NEW",
        "contractPairId": 1,
        "currentQuantity": "0.06",
        "direction": "LONG",
        "marginAmount": "39.890168",
        "marginCallAmount": "7.5",
        "openingPrice": "2300.045",
        "operateQuantity": "0",
        "positionId": 4796701,
        "positionType": 3,
        "symbol": "ETH-USD"
    },
    "event": "api_position",
    "success": true
}
```

<br>