get
https://api.liquiditytech.com/api/v1/trading/position
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 Parameters
| Field | Type | Necessary | Description |
|---|---|---|---|
sym | String | N | Trading pair unique identifier. e.g. BINANCE_PERP_BTC_USDT, OKX_PERP_BTC_USDT, EDX_PERP_ETH_USDT. If omitted, all pairs are returned. |
exchange | String | N | Exchange filter. e.g. BINANCE, OKX, EDX. |
Response Fields
| 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: LONG, SHORT, or NONE. |
positionMargin | String | Position margin. |
positionMM | String | Position maintenance margin. |
positionQty | String | Position quantity. Positive indicates long, negative indicates short. 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 | Current leverage. |
maxLeverage | String | Maximum allowed leverage. |
riskLevel | String | Risk level. See Trading Rules for detail. |
fee | String | Trading fee. |
fundingFee | String | Funding fee. |
createAt | String | Creation timestamp in milliseconds. |
updateAt | String | Last update timestamp in milliseconds. |
liqPrice | String | Estimated liquidation price. Returns a numeric string (e.g. "913.006664676013") when calculable; null if position size is too small to trigger liquidation. |
tpslOrder | Array | List of associated Take-Profit / Stop-Loss orders. |