跳到主要内容

机器人改单

机器人专用改单接口,直接调用撮合引擎撤单 + 下单,不涉及 DB 和资产。

🔒 需要 IP 白名单授权。

接口信息

  • 方法: PUT
  • 路径: /api/v1/bot/orders/{id}

请求参数

参数位置类型必填说明
idpathstring原订单 ID

Body

参数类型必填说明
symbolstring交易对(必填,因为不查库)
sidestring方向:buy / sell(必填)
new_pricestring新价格
new_qtystring新数量
client_order_idstring新订单的客户端 ID

请求示例

PUT /api/v1/bot/orders/1234567890123456789
{
"symbol": "BTC_USDT",
"side": "buy",
"new_price": "31000",
"new_qty": "0.2",
"client_order_id": "bot-new-order-001"
}

响应字段

字段类型说明
codeinteger状态码
messagestring返回消息
data.order_idstring新订单 ID
data.modify_idstring改单 ID
data.client_order_idstring客户端订单 ID

响应示例

{
"code": 0,
"message": "success",
"data": {
"order_id": "1234567890123456789",
"modify_id": "1234567890123456789",
"client_order_id": "bot-new-order-001"
}
}