API Reference

Get Futures positions

Weight: 1

Request Parameters


PARAMETERTYPEReq'dExample valuesDESCRIPTION
symbolSTRINGETHUSDT-PERPETUALName of the contract. Return results for all symbols if not specified
sideSTRINGLONGLONG or SHORT. Direction of the position. If not sent, positions for both sides will be returned.
recvWindowLONG5000recv window
timestampLONGY1714311403031Timestamp

Response Content


PARAMETERTYPEExample valuesDESCRIPTION
symbolSTRINGBTCUSDT-PERPETUALName of the contract. Return results for all symbols if not specified
sideSTRINGLONGPosition side, LONG or SHORT
avgPriceFLOAT100Average price for opening the position.
positionFLOAT20Amount of contracts opened
availableFLOAT15Amount of contracts available to close
leverageFLOAT5Leverage of the position
lastPriceFLOAT100Last trade price of the symbol
positionValueFLOAT2000Current position value.
liquidationPriceFLOAT80Forced liquidation price
marginFLOAT20Margin for this position.
marginRateFLOAT0.2Margin rate for current position
profitRateFLOAT0.0000333Rate of return for the position
unrealizedPnLFLOAT0Unrealized profit and loss for current position held
realizedPnLFLOAT6.8Cumulative realized profit and loss for this symbol
Language
Credentials
Header
Click Try It! to start a request and see the response here!