跳到主要内容

WS 改单

WS 改单

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

前置条件

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

请求格式

{"action":"batch-amend-orders","param":{"id":"1006","args":[{...},{...}]}}
字段必填类型描述
actionstring固定为 "batch-amend-orders"
paramobject批量改单参数
param.idstring客户端请求 ID
param.argsarray改单参数数组,1~20 个对象

args[N] 对象字段

字段名必填类型描述
ordIdstring委托 ID
pxnumber修改后的价格
szinteger修改后的数量(张)

请求示例

{
"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"}]}

响应参数

字段名类型描述
idstring对应请求 ID
actionstring固定为 "batch-amend-orders"
codestring处理结果码,"0" 表示已处理
msgstring处理结果说明
dataarray每笔结果,顺序与 args 一致
data[].ordIdstring委托 ID,失败时为空
data[].sCodestring单笔结果码,"0" 表示成功
data[].sMsgstring单笔结果说明

处理规则

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