查看止盈止损

请求类型: GET 描述: /future/trade/v1/entrust/profit-list

---

限流规则

200/s/apikey

---

参数说明

名称	类型	必填	默认值	描述	范围
symbol	string	TRUE	N/A	交易对（不传则查询所有交易对）	—
page	integer	FALSE	1	页码	—
size	integer	FALSE	10	每页数量	—
startTime	integer	FALSE	N/A	开始时间	—
endTime	integer	FALSE	N/A	结束时间	—
state	string	TRUE	N/A	订单状态：NOT_TRIGGERED（新订单）；TRIGGERING（触发中）；TRIGGERED（已触发）；USER_REVOCATION（用户撤销）；PLATFORM_REVOCATION（平台撤销）；EXPIRED（已过期）；UNFINISHED（未完成）；HISTORY（历史）	NOT_TRIGGERED; TRIGGERING; TRIGGERED; USER_REVOCATION; PLATFORM_REVOCATION; EXPIRED; UNFINISHED; HISTORY

---

请求示例

curl -G "https://fapi.xt.com/future/trade/v1/entrust/profit-list" \
    -H "validate-appkey: $APPKEY"              # 必须
    -H "validate-timestamp: $TIMESTAMP"        # 必须
    -H "validate-signature: $SIGNATURE"        # 必须
    -H "Content-Type: application/x-www-form-urlencoded"  # 必须
    -d "symbol=btc_usdt"                       # 必须
    -d "state=NOT_TRIGGERED"                   # 必须
    -d "page=1" \
    -d "size=10"

---

响应示例

{
  "error": {
    "code": "",
    "msg": ""
  },
  "msgInfo": "",
  "result": {
    "items": [
      {
        "createdTime": 0,                     // 时间
        "entryPrice": 0,                      // 开仓平均价格
        "executedQty": 0,                     // 实际成交
        "isolatedMargin": 0,                  // 逐仓保证金
        "origQty": 0,                         // 数量（张）
        "positionSide": "",                   // 持仓方向
        "positionSize": 0,                    // 持仓数量（张）
        "profitId": 0,                        // 订单ID
        "state": "",                          // 订单状态：NOT_TRIGGERED（未触发）；TRIGGERING（触发中）；TRIGGERED（已触发）；USER_REVOCATION（用户撤销）；PLATFORM_REVOCATION（平台撤销）；EXPIRED（已过期）
        "symbol": "",                         // 交易对
        "triggerProfitPrice": 0,              // 止盈价格
        "triggerStopPrice": 0,                // 止损价格
        "profitDelegateOrderType": "LIMIT",   // 止盈委托订单类型：LIMIT（限价）；MARKET（市价）
        "profitDelegatePrice": 0,             // 止盈委托价格
        "profitDelegateTimeInForce": "GTC",   // 止盈委托订单有效期：GTC, FOK, IOC, GTX
        "stopDelegateOrderType": "LIMIT",     // 止损委托订单类型：LIMIT（限价）；MARKET（市价）
        "stopDelegatePrice": 0,               // 止损委托价格
        "stopDelegateTimeInForce": "GTC"      // 止损委托订单有效期：GTC, FOK, IOC, GTX
      }
    ],
    "page": 0,
    "ps": 0,
    "total": 0
  },
  "returnCode": 0
}

---

错误码

错误码	描述
invalid_symbol	交易对不存在
invalid_position_type	持仓类型不正确
invalid_position_side	仓位方向不正确
invalid_state	state类型不正确