获取持仓信息

请求类型 GET

接口地址: /future/user/v1/position/list

---

请求参数

参数名	类型	是否必填	默认值	描述
symbol	string	否	N/A	交易对（不传时查询所有交易对的持仓信息）

---

限流规则

200次/秒/apikey

---

请求示例

Request

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

响应示例

Response

{
  "error": {
    "code": "",
    "msg": ""
  },
  "msgInfo": "",
  "result": [
    {
      "autoMargin": false,        // 是否自动追加保证金
      "availableCloseSize": 0,    // 可平仓数量（张）
      "closeOrderSize": 0,        // 挂单数量（张）
      "entryPrice": 0,            // 开仓均价
      "isolatedMargin": 0,        // 逐仓保证金
      "leverage": 0,              // 杠杆倍数
      "openOrderMarginFrozen": 0, // 占用开仓保证金
      "positionSide": "",         // 持仓方向
      "positionSize": 0,          // 持仓数量（张）
      "positionType": "",         // 仓位类型
      "realizedProfit": 0,        // 已实现盈亏
      "symbol": ""                // 交易对
    }
  ],
  "returnCode": 0
}

错误码

Error code	Desc
invalid_symbol	交易对不存在