WS 交易

WS 下单

通过私有 WebSocket 连接提交订单。

前置条件

在发送交易请求前，必须先获取有效的 listenKey 并建立私有 WebSocket 连接。

---

批量下单

单次请求最多提交 5 笔订单。

请求格式

{"action":"batch-orders","param":{"id":"1002","args":[{...},{...}]}}

字段	必填	类型	描述
action	是	string	固定为 "batch-orders"
param	是	object	批量下单参数
param.id	是	string	客户端请求 ID
param.args	是	array	下单参数数组，1~5 个对象

args[N] 对象字段

字段名	必填	类型	描述
instId	是	string	产品 ID，如 "BTC-USDT-SWAP"、"BTC-USDT"
tdMode	是	string	交易模式：cash、cross、isolated
ccy	否	string	保证金币种
side	是	string	订单方向：buy、sell
posSide	否	string	持仓方向：long、short。SWAP 必填
mrgPosition	否	string	仓位模式：merge、split。SWAP 必填
closePosId	否	string	分仓平仓时的仓位 ID
ordType	是	string	订单类型：market、limit、post_only、ioc
sz	是	string	委托数量
px	否	string	委托价格。limit、post_only 必填
tgtCcy	否	string	市价单数量类型：base_ccy、quote_ccy。仅币币
tpTriggerPx	否	string	止盈触发价。仅币币
slTriggerPx	否	string	止损触发价。仅币币

请求示例

{
  "action": "batch-orders",
  "param": {
    "id": "1002",
    "args": [
      {
        "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"
      }
    ]
  }
}

响应格式

{"id":"1002","action":"batch-orders","code":"0","msg":"","data":[{"ordId":"1000587866646229","sCode":"0","sMsg":""},{"ordId":"","sCode":"50012","sMsg":"order failed: InsufficientMoney"}]}

响应参数

字段名	类型	描述
id	string	对应请求 ID
action	string	固定为 "batch-orders"
code	string	处理结果码，"0" 表示已处理
msg	string	处理结果说明
data	array	每笔结果，顺序与 args 一致
data[].ordId	string	订单 ID，失败时为空
data[].sCode	string	单笔结果码，"0" 表示成功
data[].sMsg	string	单笔结果说明

---

错误码

错误码	说明
0	成功
50002	内部错误
50003	数据验证失败
50005	无效参数
50006	缺少参数
50008	无效配置
50011	不支持
50012	操作失败
50018	无效请求

批量下单处理规则

场景	错误码	错误信息
全部下单成功	0
param 非合法 JSON	50018	Invalid request json
args 为空或超过 5 个	50005	args length must be between 1 and 5
单笔：字段解析失败	50003	Invalid arg（单笔 sCode）
单笔：缺少 posSide/mrgPosition	50006	posSide/mrgPosition is required（单笔 sCode）
单笔：instId 无效	50005	invalid instId（单笔 sCode）
单笔：不支持的类型/订单	50011	unsupported（单笔 sCode）
单笔：后端下单失败	50012	Order failed（单笔 sCode）

注意事项

• 订单状态变化通过现有 PushOrder 报单通知推送（action=PushOrder，table=Order）
• 成交结果通过现有 PushTrade 成交通知推送（action=PushTrade，table=Trade）
• 本功能不新增推送频道