Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
公共频道
私有频道
    下单撤单修改订单订单成交快速成交批量下单批量撤单批量修改订单账户持仓ADL通知策略订单频道
Reality
SBE
私有频道

修改订单

描述

异步改单说明:

  • 改单为异步执行,收到成功响应后仍可能最终失败
  • 失败时不会收到额外通知,但可能收到订单成交或撤销的更新(例如,订单在改单请求生效前被取消或完全成交)
  • 建议通过REST API查询当前订单状态来确认改单是否成功:如订单仍存在则可重试;如不存在则说明已成交或撤销,无需再操作
Code
{ "args": [ { "autoCancel": "yes", "clientOid": "135423791666666666", "orderId": "1354237910666666666", "price": "5", "qty": "2", "symbol":"BTCUSDT" } ], "id": "ae5ea6df-215f-4750-a700-d487d03ac020", "op": "trade", "category": "usdt-futures", "topic": "modify-order" }

请求参数

参数名参数类型是否必须描述
opString是操作:
trade 交易
idString是请求标识
topicString是频道名:
modify-order 修改订单
categoryString否业务线,仅接受小写
spot现货交易
margin 杠杆交易
usdt-futures U本位合约
coin-futures 币本位合约
usdc-futures USDC合约
argsList<Object>是请求订阅的频道列表
> orderIdString否订单id
orderId和clientOid二者必填其一
如同时传入orderId及clientOid,则orderId优先级更高,忽略clientOid入参
> clientOidString否自定义订单id
orderId和clientOid二者必填其一
如同时传入orderId及clientOid,则orderId优先级更高,忽略clientOid入参
> qtyString否下单数量
- 现货
市价买单,单位为quote coin
限价及市价卖单,单位为base coin
- 合约
单位为base coin
> priceString否下单价格
订单类型为限价单limit时,该字段必填
订单类型为市价单market时,该字段失效
> autoCancelString否修改订单失败是否撤销原订单
yes撤销
no不撤销
若设置为 yes:撮合改单失败后,直接执行撤单;撤单后,柜台将拒绝该订单的后续改单请求(含在途及新请求)。
> symbolString否交易对名称,不区分大小写
Code
{ "event": "trade", "id": "ae5ea6df-215f-4750-a700-d487d03ac020", "topic": "modify-order", "args": [ { "orderId": "135423791666666666", "clientOid": "1354237910666666666", "receiveTime": "1750034396998123", "pushTime": "1750034397076456" } ], "code": "0", "msg": "Success", "connId": "xxxxxxxxxx", "rateLimit": [ { "limit": "10", "remaining": "9" } ], "ts": "1758601481031" }

响应参数说明

返回字段参数类型字段说明
eventString事件
trade 交易
error参数错误
idString请求标识
topicString频道名
modify-order修改订单
argsList<Object>订单列表
> orderIdString订单ID
> clientOidString自定义订单ID
> receiveTimeString网关接收时间
Unix微秒时间戳
> pushTimeString网关推送时间
Unix微秒时间戳
codeString状态码
msgString状态消息
connIdString连接ID
rateLimitArray限频余额数组
> limitString该维度限额
> remainingString剩余可用次数
tsString时间戳
撤单订单
JSON
JSON