get
https://api.liquiditytech.com/api/v1/trading/position
Description
Retrieves the current holding details for a specific trading pair within a portfolio. This includes critical financial data such as position size, margin requirements, unrealized profit and loss (PNL), and leverage settings.
Permission
RapidX API key with read-only permission is sufficient. No trading / write permission is required.
Rate Limit
300 requests per 60 seconds.
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| sym | String | N | Trading pair unique identifier, example: BINANCE_PERP_BTC_USDT, OKX_PERP_BTC_USDT, EDX_PEPR_ETH_USDT |
| exchange | String | N | exchange, example: BINANCE, OKX, EDX |
Respone
| Field | Type | Remark |
|---|---|---|
| positionId | String | Unique identifier for the position |
| portfolioId | String | Unique identifier for the portfolio |
| sym | String | Trading pair unique identifier |
| positionSide | String | Side of the position (e.g., LONG, SHORT, NONE) |
| positionMargin | String | Position margin |
| positionMM | String | Position maintenance margin |
| positionQty | String | Position quantity. Positive indicates long positions, negative indicates short positions. Units vary by exchange: contracts for OKX, base currency for BINANCE. |
| positionValue | String | Position value |
| unrealizedPNL | String | Unrealized PNL |
| unrealizedPNLRate | String | Unrealized PNL percentage |
| avgPrice | String | Average entry 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 | Creation timestamp (millisecond) |
| updateAt | String | Last update timestamp (millisecond) |
| tpslOrder | Array | List of associated Take-Profit/Stop-Loss orders |