get
https://api.connex.trade/api/v1/trading/position
Permission
- Applies to both primary user and trading portfolio's API Key.
- Permission: READ.
Rate Limit
- 150 requests per 60 seconds
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| sym | String | N | Trading pair unique identifier, e.g: BINANCE_PERP_BTC_USDT, OKX_PERP_BTC_USDT. Without specifying any pair, all positions setup initial leverage will be returned. |
| exchange | String | N | exchange, example: BINANCE, OKX |
| zeroFilter | String | N | true / false, Param to filter out positions of 0 size. Default is false. |
Respone
| Field | Type | Remark |
|---|---|---|
| positionId | String | Position Id |
| portfolioId | String | Portfolio Id |
| sym | String | Trading pair unique identifier |
| positionSide | String | NONE / LONG / SHORT, NONEstands for one-way mode position. |
| positionMargin | String | Position margin |
| positionMM | String | Position maintain margin |
| positionQty | String | Position quantity(Positive means Long, Negative means Short positions), the unit for OKX is piece, for BINANCE is coin |
| positionValue | String | Position value |
| unrealizedPNL | String | Unrealized PNL |
| unrealizedPNLRate | String | Unrealized PNL rate |
| avgPrice | String | Average price |
| markPrice | String | Mark price |
| leverage | String | Leverage |
| maxLeverage | String | Max leverage |
| riskLevel | String | Risk level. More detail in Trading Rules |
| fee | String | Trading fee |
| fundingFee | String | Funding fee |
| createAt | String | Create time |
| updateAt | String | Update time |
| liqPrice | String | Estimated liquidation price of position. If the data is null, it means there will be no forced liquidation |