批量下单

描述

• 单次调用最多支持20笔订单
• 请联系对接BD或者RM申请接入权限

请求示例

{
    "op": "trade",
    "id": "1750035029506",
    "category": "spot",
    "topic": "batch-place",
    "args": [
        {
            "clientOid": "xxxxxxxx",
            "orderType": "limit",
            "price": "100",
            "qty": "0.1",
            "side": "buy",
            "symbol": "BTCUSDT",
            "timeInForce": "gtc"
        },
        {
            "clientOid": "xxxxxxxx",
            "orderType": "limit",
            "price": "100",
            "qty": "0.15",
            "side": "buy",
            "symbol": "BTCUSDT",
            "timeInForce": "gtc"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作: trade 交易
id	String	是	请求标识
topic	String	是	频道名: place-order 下单
category	String	是	业务线 spot现货交易 margin 杠杆交易 usdt-futures U本位合约 coin-futures 币本位合约 usdc-futures USDC合约
args	List<Object>	是	请求订阅的频道列表
> symbol	String	是	交易对名称
> orderType	String	是	订单类型 limit : 限价 market : 市价
> qty	String	是	下单数量 - 现货 市价买单，单位为quote coin 限价及市价卖单，单位为base coin - 合约 单位为base coin
> price	String	是	下单价格 订单类型为限价单limit时，该字段必填 订单类型为市价单market时，该字段失效
> side	String	是	下单方向 buy: 买 sell: 卖
> posSide	String	否	交易方向 long 多仓 short 空仓 只限于合约传此参数 其他忽略 用于合约双向持仓
> timeInForce	String	否	订单执行策略 gtc: 普通订单, 订单会一直有效，直到被成交或者取消 ioc: 无法立即成交的部分就撤销 fok: 无法全部立即成交就撤销 post_only: 只做maker 订单类型为限价单limit时必填，若省略则默认为gtc 订单类型为市价单market时，该字段失效，系统会按照ioc执行
> reduceOnly	String	否	是否只减仓 YES是 NO否 默认值为NO; 仅适用于买卖单向持仓模式下
> clientOid	String	否	自定义订单id
> stpMode	String	否	STP（自成交预防）模式 none：不设置STP（默认值） cancel_taker：取消taker单 cancel_maker：取消maker单 cancel_both：两者都取消
> tpTriggerBy	String	否	预设止盈触发类型 market市场价格 mark标记价格 如不填写，默认值为market市场价格 该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效
> slTriggerBy	String	否	预设止损触发类型 market市场价格 mark标记价格 如不填写，默认值为market市场价格 该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效
> takeprofit	String	否	预设止盈触发价格
> stoploss	String	否	预设止损触发价格
> tpOrderType	String	否	止盈触发的策略单类型 limit 限价单 market 市价单
> slOrderType	String	否	止损触发的策略单类型 limit 限价单 market 市价单
> tpLimitPrice	String	否	止盈策略单执行价格 仅限价单tpOrderType=limit时有效，市价单忽略该参数
> slLimitPrice	String	否	止损策略单执行价格 仅限价单slOrderType=limit时有效，市价单忽略该参数

响应示例

{
  "event": "trade",
  "id": "1750035029506",
  "category": "spot",
  "topic": "batch-place",
  "args": [
    {
      "code": "0",
      "msg": "Success",
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx"
    },
    {
      "code": "0",
      "msg": "Success",
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx"
    }
  ],
  "code": "0",
  "msg": "Success",
  "ts": "1750035029925"
}

响应参数说明

返回字段	参数类型	字段说明
event	String	事件 trade 交易 error参数错误
id	String	请求标识
topic	String	频道名 batch-place 批量下单
category	String	业务线 spot现货交易 margin 杠杆交易 usdt-futures U本位合约 coin-futures 币本位合约 usdc-futures USDC合约
args	List<Object>	订单列表
> symbol	String	交易对名称，如BTCUSDT
> orderId	String	订单ID
> clientOid	String	自定义订单ID
> code	String	状态码
> msg	String	状态消息
code	String	状态码
msg	String	状态消息
ts	String	时间戳