WS 改单

WS 改单

通过私有 WebSocket 连接修改订单。单次最多 20 笔。

前置条件

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

请求格式

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

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

args[N] 对象字段

字段名	必填	类型	描述
ordId	是	string	委托 ID
px	是	number	修改后的价格
sz	否	integer	修改后的数量（张）

请求示例

{
  "action": "batch-amend-orders",
  "param": {
    "id": "1006",
    "args": [
      {"ordId": "1000587867035933", "px": 6000.5, "sz": 5},
      {"ordId": "1000587867035934", "px": 6100.5}
    ]
  }
}

响应格式

{"id":"1006","action":"batch-amend-orders","code":"0","msg":"","data":[{"ordId":"1000587867035933","sCode":"0","sMsg":""},{"ordId":"","sCode":"50012","sMsg":"amend failed: OrderNotFound"}]}

响应参数

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

处理规则

场景	错误码	错误信息
全部改单成功	0
param 非合法 JSON	50018	Invalid request json
args 为空或超过 20 个	50005	args length must be between 1 and 20
单笔：字段解析失败	50003	Invalid arg（单笔 sCode）
单笔：缺少 ordId/px	50003	ordId/px is required（单笔 sCode）
单笔：px/sz 无效	50005	invalid px/sz（单笔 sCode）
单笔：改单失败	50012	amend failed（单笔 sCode）