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
Requires an API key with read permission. No trading or writing permission required.
Rate Limit
300 requests per 60 seconds.
Request
| Field | Type | Necessary | Description |
|---|---|---|---|
| sym | String | N | Trading pair unique identifier. Example: BINANCE_PERP_BTC_USDT, OKX_PERP_BTC_USDT, EDX_PERP_ETH_USDT. If omitted, all pairs are returned. |
| exchange | String | N | exchange, example: BINANCE, OKX, EDX |
Respone
| Field | Type | Description |
|---|---|---|
| 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) |
| liqPrice | String | Estimated liquidation price. Returns a numeric string (e.g., "913.006664676013") if the position is active and calculable; returns null if the position size is too small to trigger liquidation. |
| tpslOrder | Array | List of associated Take-Profit/Stop-Loss orders |