get https://api-glb.sim.hashkeydev.com/api/v1/futures/positions
Retrieves current positions.
Weight: 1
Request Parameters
| PARAMETER | TYPE | Req'd | Example values | DESCRIPTION |
|---|---|---|---|---|
| symbol | STRING | ETHUSDT-PERPETUAL | Name of the contract. Return results for all symbols if not specified | |
| side | STRING | LONG | LONG or SHORT. Direction of the position. If not sent, positions for both sides will be returned. | |
| recvWindow | LONG | 5000 | recv window | |
| timestamp | LONG | Y | 1714311403031 | Timestamp |
Response Content
| PARAMETER | TYPE | Example values | DESCRIPTION |
|---|---|---|---|
| symbol | STRING | BTCUSDT-PERPETUAL | Name of the contract. Return results for all symbols if not specified |
| side | STRING | LONG | Position side, LONG or SHORT |
| avgPrice | STRING | 100 | Average price for opening the position. |
| position | STRING | 20 | Amount of contracts opened |
| available | STRING | 15 | Amount of contracts available to close |
| leverage | STRING | 5 | Leverage of the position |
| lastPrice | STRING | 100 | Last trade price of the symbol |
| positionValue | STRING | 2000 | Current position value. |
| liquidationPrice | STRING | 80 | Forced liquidation price |
| margin | STRING | 20 | Margin for this position. |
| marginRate | STRING | 0.2 | Margin rate for current position |
| profitRate | STRING | 0.0000333 | Rate of return for the position |
| unrealizedPnL | STRING | 0 | Unrealized profit and loss for current position held |
| realizedPnL | STRING | 6.8 | Cumulative realized profit and loss for this symbol |
| marginType | STRING | ISOLATED | Margin type. Possible values include CROSS, ISOLATED |
| minMargin | STRING | 2334.344 | {Depreciated} Min margin. Implies the maximun value allowed for deduction. Will rename to"reducibleQty" next iteration |
| reducibleQty | STRING | 2334.344 | Min margin. Implies the maximun value allowed for deduction. |