批量下单

• 普通用户:限速5次/秒，根据uid限频
• 跟单交易员:限速1次/秒，根据uid限频

描述

用于合约批量下单

• 单向持仓时，必须省略tradeSide参数；
• 双向持仓时，开多规则为：side=buy,tradeSide=open；开空规则为：side=sell,tradeSide=open；平多规则为：side=buy,tradeSide=close；平空规则为：side=sell,tradeSide=close

HTTP请求

• POST /api/v2/mix/order/batch-place-order

请求示例

curl -X POST "https://api.bitget.com/api/v2/mix/order/batch-place-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 '{ 
    "symbol": "BTCUSDT", 
    "productType": "usdt-futures", 
    "marginMode": "crossed", 
    "marginCoin": "USDT", 
    "orderList": [{ 
            "size": "1", 
            "side": "buy", 
            "tradeSide": "open", 
            "orderType": "market", 
            "force": "gtc", 
            "clientOid": "123456", 
            "reduceOnly": "NO", 
            "presetStopSurplusPrice": "20000", 
            "presetStopLossPrice": "10000" 
        } 
    ] 
}'

请求参数

参数名	参数类型	是否必须	描述
symbol	String	是	交易对
productType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
marginCoin	String	是	保证金币种 必须大写
marginMode	String	是	仓位模式 isolated：逐仓 crossed：全仓
orderList	List	是	下单集合。最大订单数(列表长度)：50
>size	String	是	下单数量
>price	String	否	下单价格。 orderType为limit时必填
>side	String	是	下单方向 buy：买 sell：卖
>tradeSide	String	否	交易方向 开平仓双向持仓模式下必填，单向持仓时不要填，否则会报错 open: 开 close: 平
>orderType	String	是	订单类型 limit: 限价单， market: 市价单
>force	String	否	订单有效期 orderType为limit时必填，若省略则默认为gtc ioc: 无法立即成交的部分就撤销 fok: 无法全部立即成交就撤销 gtc: 普通订单, 订单会一直有效，直到被成交或者取消 post_only: 只做maker
>clientOid	String	否	自定义订单id 唯一,幂等时间为20分钟
>reduceOnly	String	否	是否只减仓 YES，NO 默认为NO 仅适用于单向持仓模式。
>presetStopSurplusPrice	String	否	止盈值 为空则默认不设止盈。
>presetStopLossPrice	String	否	止损值 为空则默认不设止损。
>stpMode	String	否	STP模式， default none none 不设置STP cancel_taker 取消taker单 cancel_maker 取消maker单 cancel_both 两者都取消

返回示例

{
    "code": "00000",
    "data": {
        "successList": [
            {
                "orderId": "121211212122",
                "clientOid": "BITGET#121211212122"
            }
        ],
        "failureList": []
    },
    "msg": "success",
    "requestTime": 1627293504612
}

返回参数

返回字段	参数类型	字段说明
successList	List<Object>	成功单集合
>orderId	String	订单id
>clientOid	String	自定义订单id
failureList	List<Object>	失败单集合
>orderId	String	订单id
>clientOid	String	自定义订单id
>errorMsg	String	失败原因
>errorCode	String	错误码