创建策略单

描述

创建策略单

API Broker返佣标识:
需在HTTP Header请求头中添加如下代码块
"X-CHANNEL-API-CODE":"your-channel-api-code"

HTTP请求

POST /api/v3/trade/place-strategy-order
限频规则: 10次/秒/UID
需要统一账户交易读写权限

请求示例
curl -X POST "https://api.bitget.com/api/v3/trade/place-strategy-order" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{ "category": "usdt-futures","symbol": "BTCUSDT","posSide": "long","stopLoss": "99000","takeProfit": "100800","clientOid": "121211212122"}'

公共请求参数

以下字段适用于所有策略 type。各策略类型专属的参数详见下方各自的独立小节。

参数名	参数类型	是否必须	描述
category	String	是	产品类型 `SPOT` 现货 `MARGIN` 杠杆 `USDT-FUTURES` USDT合约 `COIN-FUTURES` 币本位合约 `USDC-FUTURES` USDC合约
symbol	String	是	交易对名称例如：`BTCUSDT`
type	String	否	策略类型 `tpsl`止盈止损 `trigger`计划委托 `oco` OCO `trailing_stop`追踪委托 `iceberg`冰山委托 `twap`分时委托默认为`tpsl`止盈止损
side	String	否	交易方向 `buy`买 `sell`卖双向持仓：开多：`side=buy` & `posSide=long` 开空：`side=sell` & `posSide=short` 平多：`side=sell` & `posSide=long` 平空：`side=buy` & `posSide=short` 单向持仓：开多 `side=buy` 开空 `side=sell` 平多 `side=sell` & `reduceOnly=yes` 平空 `side=buy` & `reduceOnly=yes`
posSide	String	否	持仓方向 `long` 多 `short` 空
qty	String	否	委托数量
clientOid	String	否	自定义策略订单id 仅在 `type=tpsl` 时生效，其他策略类型不支持

策略类型

UTA统一账户支持以下策略订单类型，通过 type 参数指定。并非所有策略类型都支持全部产品线，请在下单前参考以下支持矩阵。

type	说明	SPOT	MARGIN	USDT-FUTURES	COIN-FUTURES	USDC-FUTURES
`tpsl`	止盈止损	✅	✅	✅	✅	✅
`trigger`	计划委托	✅	✅	✅	✅	✅
`oco`	二选一委托OCO	✅	✅	❌	❌	❌
`trailing_stop`	追踪委托	✅	❌	✅	❌	✅
`iceberg`	冰山委托	✅	❌	✅	❌	✅
`twap`	分时委托TWAP	✅	❌	✅	❌	✅

止盈止损（`type=tpsl`）

为已有持仓附加止盈和/或止损保护。行情（或标记价格）到达设定的触发价格后，Bitget将代为提交限价或市价订单以平仓。

参数名	参数类型	是否必须	描述
tpslMode	String	否	止盈止损模式 `full`全部仓位止盈止损 `partial`部分仓位止盈止损如不填写，默认值为full全部止盈止损
qty	String	否	委托数量 `tpslMode=partial`时必填，单位为`base coin`
reduceOnly	String	否	是否只减仓 `yes`是 `no`否
tpTriggerBy	String	否	止盈触发类型 `market`市场价格 `mark`标记价格如不填写，默认值为`market`市场价格
slTriggerBy	String	否	止损触发类型 `market`市场价格 `mark`标记价格如不填写，默认值为`market`市场价格
takeProfit	String	否	止盈触发价格
stopLoss	String	否	止损触发价格
tpOrderType	String	否	止盈触发的策略单类型 `limit` 限价单 `market` 市价单如不填写，默认值为`market`
slOrderType	String	否	止损触发的策略单类型 `limit` 限价单 `market` 市价单如不填写，默认值为`market`
tpLimitPrice	String	否	止盈策略单执行价格仅限价单`tpOrderType=limit`时有效，市价单忽略该参数
slLimitPrice	String	否	止损策略单执行价格仅限价单`slOrderType=limit`时有效，市价单忽略该参数

计划委托（`type=trigger`）

创建一个仅在行情到达设定触发价格后才会挂出的条件订单，适用于突破入场或提前设置止损入场，无需先持有仓位。

参数名	参数类型	是否必须	描述
qty	String	否	委托数量计划委托订单必填，单位为`base coin`
reduceOnly	String	否	是否只减仓 `yes`是 `no`否
triggerBy	String	否	计划委托触发价格类型 `market`市场价格 `mark`标记价格如不填写，默认值为`market`市场价格
triggerPrice	String	否	计划委托触发价格仅限价单`triggerOrderType=limit`时有效，市价单忽略该参数
triggerOrderType	String	否	计划委托订单类型 `limit`限价单 `market`市价单
triggerOrderPrice	String	否	计划委托执行价格仅限价单`triggerOrderType=limit`时有效，市价单忽略该参数

二选一委托OCO（`type=oco`）

OCO（二选一委托）一次同时挂出两笔订单——一笔直接限价单和一笔计划委托单，组成一对订单。任意一笔成交或触发后会自动撤销另一笔，可在一次请求中同时设置限价止盈/抄底和追涨/止损计划委托。

参数名	参数类型	是否必须	描述
ocoParams	List<String>	是	OCO参数列表
>ocoLimitPrice	String	是	限价委托价格 `side=buy`：限价抄底价 `side=sell`：限价止盈价作用于非触发的直接挂单订单
>ocoTriggerPrice	String	是	计划委托触发价 `side=buy`：追涨触发价 `side=sell`：止损触发价作用于触发的计划委托订单
>ocoOrderType	String	是	计划委托执行订单类型 `limit`限价 `market`市价
>ocoOrderPrice	String	否	计划委托执行价格 `side=buy`：追涨价格 `side=sell`：止损价格 `ocoOrderType=limit`时必填

追踪委托（`type=trailing_stop`）

追踪委托在激活后按固定比例或价差动态跟随行情价格移动，当价格从最优点回撤达到该追踪幅度时提交预设订单，可在行情持续朝有利方向运行时锁定利润。

参数名	参数类型	是否必须	描述
trailingStopParams	List<String>	是	追踪委托参数列表
>activationPrice	String	是	激活价格行情达到该价格后开始追踪
>activationType	String	是	激活价格类型 `market`市场价格 `mark`标记价格 `index`指数价格适用于合约，现货仅支持`market`
>trailType	String	是	追踪幅度模式 `ratio`比例 `spread`价差
>trailVariance	String	是	追踪幅度 `trailType=ratio`时：现货允许范围[0.1, 20]，合约允许范围[0.1, 10]
>preOrderType	String	是	预设委托价格类型 `limit`限价 `market`市价
>preOrderPrice	String	否	预设委托价格 `preOrderType=limit`时必填

冰山委托（`type=iceberg`）

冰山委托将一笔大额订单拆分为多笔较小的子订单，并随时间逐步挂出至订单簿，降低对市场的冲击，同时隐藏订单总量。

参数名	参数类型	是否必须	描述
icebergParams	List<String>	是	冰山委托参数列表
>splitMode	String	是	拆单类型 `quantity`按单笔数量 `order`按拆单数量
>qtyPerOrder	String	否	单笔数量 `splitMode=quantity`时必填
>splitOrderNumbers	String	否	拆单数量 `splitMode=order`时必填范围[1, 100]
>orderPreference	String	是	挂单偏好 `faster_execution`更快成交 `fixed_distance`固定距离 `fixed_price`固定价格
>executionStrategy	String	否	子单成交策略 `queue1`同向价1 `counterparty1`对手价1 `orderPreference=faster_execution`时有效，默认`queue1`
>fixedDistanceType	String	否	子单固定距离类型 `spread`按价差 `percentage`按比例与买一/卖一价格的距离 `orderPreference=fixed_distance`时有效，默认`spread`
>distance	String	否	子单距离数值 `fixedDistanceType=spread`时代表价差 `fixedDistanceType=percentage`时代表比例
>fixedPrice	String	否	子单固定价格 `orderPreference=fixed_price`时必填
>priceLimit	String	否	限价保护价子单价格超出该限价时不挂出 `orderPreference=faster_execution`或`orderPreference=fixed_distance`时有效

分时委托TWAP（`type=twap`）

TWAP（分时委托）将一笔订单在设定时长内按固定频率拆分为多笔等间隔子订单逐步执行，以逼近该时段的时间加权平均价格，而非一次性成交。

参数名	参数类型	是否必须	描述
twapParams	List<String>	是	分时委托参数列表
>duration	String	是	总时长单位为分钟，范围[1, 1440]，即1分钟至24小时
>interval	String	是	频率单位为秒，枚举值：`5`、`10`、`20`、`30`、`60`
>orderType	String	否	子单类型 `market`市价单 `limit`限价单默认`market`
>limitOffsetType	Number	否	限价偏离类型 `percentage`百分比 `spread`价差 `orderType=limit`时有效，默认`percentage`
>limitOffsetPercentage	Number	否	限价偏离百分比小数形式，范围[0.001, 0.1]，0.1代表10% `limitOffsetType=percentage`时必填
>limitOffsetSpread	Number	否	限价偏离绝对值 `limitOffsetType=spread`时必填与最新成交价的价差不能超过20%
>twapTriggerPrice	Number	否	策略触发价
>twapTerminationPrice	Number	否	策略停止价行情达到该价格时提前终止策略

返回示例
{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806875837,
  "data": {
    "clientOid": "121211212122",
    "orderId": "121211212122"
  }
}

返回参数

返回字段	参数类型	字段说明
orderId	String	策略订单id
clientOid	String	自定义策略订单id

创建策略单

创建策略单

描述​

HTTP请求​

公共请求参数​

策略类型​

止盈止损（type=tpsl）​

计划委托（type=trigger）​

二选一委托OCO（type=oco）​

追踪委托（type=trailing_stop）​

冰山委托（type=iceberg）​

分时委托TWAP（type=twap）​

返回参数​

您的阅读体验如何？

描述

HTTP请求

公共请求参数

策略类型

止盈止损（`type=tpsl`）

计划委托（`type=trigger`）

二选一委托OCO（`type=oco`）

追踪委托（`type=trailing_stop`）

冰山委托（`type=iceberg`）

分时委托TWAP（`type=twap`）

返回参数