跳到主要内容

批量下单

批量下单​

单次请求最多提交 5 笔订单。每笔订单独立执行，部分失败不影响其他订单结果。

请求地址​

POST /deepcoin/trade/batch-orders

请求参数​

请求体：

字段名是否必填类型字段描述
orders是array订单列表，单次最多 5 笔

单笔订单字段：

字段名是否必填类型字段描述
instId是string产品 ID
tdMode是string交易模式
逐仓: isolated
全仓: cross
现金: cash
ccy否string保证金币种，仅适用于单币种保证金模式下的全仓杠杆订单
clOrdId否string客户自定义订单 ID，长度 1-32，当前下游下单暂不支持
tag否string订单标签，长度 1-16，当前下游下单暂不支持
side是string订单方向
买: buy
卖: sell
posSide否string持仓方向，SWAP 必填
多: long
空: short
mrgPosition否string仓位模式，SWAP 必填
合仓: merge
分仓: split
closePosId否string分仓平仓时的仓位 ID
ordType是string订单类型
市价: market
限价: limit
只做 Maker: post_only
IOC: ioc
sz是string委托数量
px否string委托价格，仅适用于 limit、post_only
reduceOnly否boolean是否只减仓
tgtCcy否string市价单数量类型，仅适用于现货
base_ccy / quote_ccy
tpTriggerPx否string止盈触发价
slTriggerPx否string止损触发价

请求示例​

{
  "orders": [
    {
      "instId": "BTC-USDT-SWAP",
      "tdMode": "cross",
      "side": "buy",
      "ordType": "limit",
      "sz": "1",
      "px": "65000",
      "posSide": "long",
      "mrgPosition": "merge"
    },
    {
      "instId": "ETH-USDT-SWAP",
      "tdMode": "cross",
      "side": "sell",
      "ordType": "market",
      "sz": "2",
      "posSide": "short",
      "mrgPosition": "merge"
    }
  ]
}

响应参数​

data 为数组，每个元素对应请求 orders 中相同索引的订单结果。

字段名类型字段描述
ordIdstring订单 ID，失败时为空字符串
clOrdIdstring客户自定义订单 ID，当前返回空字符串
tagstring订单标签，当前返回空字符串
sCodestring单笔执行状态码，0 表示成功
sMsgstring单笔执行错误信息

响应示例​

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "ordId": "1000587866646229",
      "clOrdId": "",
      "tag": "",
      "sCode": "0",
      "sMsg": ""
    },
    {
      "ordId": "",
      "clOrdId": "",
      "tag": "",
      "sCode": "36",
      "sMsg": "InsufficientMoney"
    }
  ]
}