跳到主要内容

策略委托下单

策略委托下单

策略委托下单,按 ordType 区分类型。

请求地址

POST /deepcoin/v2/trade/order-algo

通用请求参数

字段名是否必填类型字段描述
instIdstring产品 ID
ordTypestring策略订单类型:conditional / tp_sl / move_order_stop
conditionalobjectordType=conditional 时必填,条件单参数
tpSlobjectordType=tp_sl 时必填,持仓止盈止损参数
moveOrderStopobjectordType=move_order_stop 时必填,追踪出场参数

ordType=conditional(条件单)

conditional 参数:

字段名是否必填类型字段描述
tdModestring交易模式:cross / isolated / cash
sidestring买卖方向:buy / sell
posSidestring持仓方向(合约必填):long / short
szstring委托数量
triggerPxstring触发价
triggerPxTypestring触发价类型:last / index / mark,默认 last
orderTypestring触发后订单类型:market / limit
orderPxstring触发后委托价,orderType=limit 时必填
mrgPositionstring仓位模式(合约必填):merge / split
closePosIdstring指定持仓 ID,分仓平仓必填
tpTriggerPxfloat64开仓后止盈触发价
tpTriggerPxTypestring止盈触发价类型:last / index / mark
tpOrdPxfloat64止盈委托价,-1 表示市价
slTriggerPxfloat64开仓后止损触发价
slTriggerPxTypestring止损触发价类型:last / index / mark
slOrdPxfloat64止损委托价,-1 表示市价

请求示例:

{
"instId": "ETH-USDT-SWAP",
"ordType": "conditional",
"conditional": {
"tdMode": "cross",
"side": "buy",
"posSide": "long",
"sz": "1",
"triggerPx": "1800",
"triggerPxType": "last",
"orderType": "limit",
"orderPx": "1795",
"mrgPosition": "merge",
"tpTriggerPx": 2200,
"tpOrdPx": -1,
"slTriggerPx": 1700,
"slOrdPx": -1
}
}

ordType=tp_sl(持仓止盈止损)

tpSl 参数:

字段名是否必填类型字段描述
tdModestring保证金模式(合约必填):cross / isolated
posSidestring持仓方向(合约必填):long / short
mrgPositionstring仓位模式(合约必填):merge / split
posIdstring仓位 ID,分仓必填
szstring止盈止损数量,不传表示全部持仓
tpTriggerPxfloat64止盈触发价,与 slTriggerPx 至少传一个
tpTriggerPxTypestring止盈触发价类型:last / index / mark
tpOrdPxfloat64止盈委托价,-1 表示市价
slTriggerPxfloat64止损触发价,与 tpTriggerPx 至少传一个
slTriggerPxTypestring止损触发价类型:last / index / mark
slOrdPxfloat64止损委托价,-1 表示市价

请求示例:

{
"instId": "ETH-USDT-SWAP",
"ordType": "tp_sl",
"tpSl": {
"tdMode": "cross",
"posSide": "long",
"mrgPosition": "merge",
"sz": "1",
"tpTriggerPx": 2200,
"tpTriggerPxType": "last",
"tpOrdPx": -1,
"slTriggerPx": 1700,
"slTriggerPxType": "last",
"slOrdPx": -1
}
}

ordType=move_order_stop(追踪出场)

moveOrderStop 参数:

字段名是否必填类型字段描述
posSidestring持仓方向:long / short
triggerPxstring激活价:-1 表示立刻激活,正数为设置激活价
retracePointstring回撤价差

请求示例:

{
"instId": "ETH-USDT-SWAP",
"ordType": "move_order_stop",
"moveOrderStop": {
"posSide": "long",
"triggerPx": "-1",
"retracePoint": "50"
}
}

响应参数

字段名类型字段描述
algoIdstring策略订单 ID(move_order_stop 返回空)
sCodestring状态码,"0" 表示成功
sMsgstring状态消息

响应示例

{
"algoId": "1000595855275418",
"sCode": "0",
"sMsg": ""
}