Position List

Position List

HTTP Request

GET /cloud/contract/v3/private/copytrading/position/list

Request Parameters

Parameter	Required	Type	Comments
symbol	false	string	Symbol

Response Parameters

Parameter	Type	Comments
list	array	Object
> symbol	string	Symbol
> side	string	Side
> size	string	Position qty
> positionValue	string	Position value
> entryPrice	string	Average entry price
> liqPrice	string	Liquidation price
> bustPrice	string	Bankruptcy price
> markPrice	string	Mark price
> leverage	string	In Isolated Margin mode, the value is set by the user. In Cross Margin mode, the value is the max leverage at current risk level
> isIsolated	boolean	true means isolated margin mode; false means cross margin mode
> positionMargin	string	Position margin
> occClosingFee	string	Position closing fee occupied (your opening fee + expected maximum closing fee)
> occFundingFee	string	Pre-occupied funding fee: calculated from position qty and current funding fee
> cumRealisedPnl	string	Accumulated realised pnl (all-time total)
> freeQty	string	Qty which can be closed. (If you have a long position, free_qty is negative. vice versa)
> unrealisedPnl	string	unrealised pnl
> positionIdx	string	Position idx, used to identify positions in different position modes:0-Single side; 1-Buy side of both side mode; 2-Sell side of both side mode
> createdTime	string	Creation time (when the order_status was Created)
> updatedTime	string	Update time

Request Example

curl --location --request GET 'https://openapi-testnet.zoomex.com/cloud/contract/v3/private/copytrading/position/list?timestamp=1689848022628&api_key=XXXXX&recv_window=5000&sign=XXXXX'

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "side": "Sell",
                "size": "1",
                "positionValue": "30335.7",
                "entryPrice": "30335.7",
                "liqPrice": "47106.80",
                "bustPrice": "47228.20",
                "markPrice": "30345.74",
                "leverage": "25",
                "isIsolated": false,
                "positionMargin": "16892.5070120428.33692",
                "occClosingFee": "28.33692",
                "occFundingFee": "0",
                "cumRealisedPnl": "2753.14804356",
                "freeQty": "1",
                "unrealisedPnl": "-10.04",
                "positionIdx": "2",
                "createdTime": "1689306525051",
                "updatedTime": "1689848022747"
            }
        ]
    }
}