Get Position Information

Type GET

Description: /future/user/v1/position/list

Parameters

Name	Type	Mandatory	Default	Description
symbol	string	No	N/A	Trading pair (queries position information for all trading pairs when not provided)

Limit Flow Rules

200/s/apikey

Request Example

Request

curl -G "https://fapi.xt.com/future/user/v1/position/list" \ 
  -H "validate-appkey: $APPKEY" \  # Required
  -H "validate-timestamp: $TIMESTAMP" \  # Required
  -H "validate-singature: $SINGATURE" \  # Required
  -H "Content-Type: application/x-www-form-urlencoded" \  # Required
  -d "symbol=btc_usdt"

Response Example

Response

{
  "error": {
    "code": "",
    "msg": ""
  },
  "msgInfo": "",
  "result": [
    {
      "autoMargin": false, // Whether to automatically call margin
      "availableCloseSize": 0, // Available quantity (Cont)
      "closeOrderSize": 0, // Pending order quantity (Cont)
      "entryPrice": 0, // Open position average price
      "isolatedMargin": 0, // Isolated Margin
      "leverage": 0, // Leverage
      "openOrderMarginFrozen": 0, // Occupied open position margin
      "positionSide": "", // Position side
      "positionSize": 0, // Position quantity (Cont)
      "positionType": "", // Position type
      "realizedProfit": 0, // Realized profit and loss
      "symbol": "" // Trading pair
    }
  ],
  "returnCode": 0
}

Error code

Error code	Desc
invalid_symbol	Symbol does not exist