条件单下单

条件单下单

条件单是指当市场价格达到预设的触发价格时，系统自动下单的订单类型

限频：每秒 1 次

请求地址

POST /deepcoin/trade/triggerOrder

请求参数

字段名	是否必填	类型	字段描述
instId	是	string	产品 ID
productGroup	是	string	交易类型 现货: Spot 永续: Swap
sz	是	string	委托数量
side	是	string	订单方向 买: buy 卖: sell
posSide	否	string	持仓方向 产品类型为 SWAP 时必填 多: long 空: short
price	否	string	限价单价格 限价单时必填，市价单不需要
isCrossMargin	是	string	是否全仓 逐仓: 0 全仓: 1
orderType	是	string	订单价格类型 限价: limit 市价: market
triggerPrice	是	string	条件单触发价格 当市场价格达到此价格时触发订单
mrgPosition	否	string	合并仓位 产品类型为 SWAP 时必填 合仓: merge 分仓: split
tdMode	是	string	交易模式 非保证金: cash 全仓: cross 逐仓: isolated

请求示例

// 场景1: 全仓合仓，开仓条件单市价
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "1",
    OrderType:     "market", // 市价
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "cross",
}

// 场景2: 全仓合仓，开仓条件限价单
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "1",
    OrderType:     "limit", // 限价
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "cross",
}

// 场景3: 全仓分仓，开仓条件单市价
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "1",
    OrderType:     "market", // 市价
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "cross",
}

// 场景4: 全仓分仓，开仓条件限价单
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "1",
    OrderType:     "limit", // 限价
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "cross",
}

// 场景5: 逐仓合仓，开仓条件单市价
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "0",
    OrderType:     "market", // 市价
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "isolated",
}

// 场景6: 逐仓合仓，开仓条件限价单
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "0",
    OrderType:     "limit", // 限价
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "isolated",
}

// 场景7: 逐仓分仓，开仓条件单市价
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "0",
    OrderType:     "market", // 市价
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "isolated",
}

// 场景8: 逐仓分仓，开仓条件限价单
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "0",
    OrderType:     "limit", // 限价
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "isolated",
}

响应参数

字段名	类型	字段描述
ordId	string	订单 ID
clOrdId	string	客户自定义订单 ID
tag	string	订单标签
sCode	string	事件执行结果的状态码 0:成功
sMsg	string	事件执行失败时的消息

响应示例

{
  "code": "0",
  "msg": "",
  "data": {
    "ordId": "1000595855275418",
    "clOrdId": "",
    "tag": "",
    "sCode": "0",
    "sMsg": "Success"
  }
}