改单
修改订单的价格和数量。
接口信息
- 方法:
PUT - 路径:
/api/v1/orders/{id} - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| id | path | string | 是 | 原订单 ID |
Body
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| new_price | string | 否 | 新价格 |
| new_qty | string | 否 | 新数量 |
| client_order_id | string | 否 | 新订单的客户端 ID |
请求示例
PUT /api/v1/orders/1234567890123456789
{
"new_price": "31000",
"new_qty": "0.2",
"client_order_id": "my-new-order-001"
}
响应字段
改单后返回新订单的下单响应,字段同下单接口。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.order_id | string | 新订单 ID |
| data.client_order_id | string | 客户端订单 ID |
| data.status | integer | 状态 |
| data.filled_qty | string | 已成交数量 |
| data.filled_quote | string | 已成交金额 |
| data.trades | array | 成交明细 |
响应示例
{
"code": 0,
"message": "success",
"data": {
"order_id": "1234567890123456789",
"client_order_id": "my-order-001",
"status": 1,
"filled_qty": "0.05",
"filled_quote": "1500",
"trades": [
{
"maker_order_id": "1234567890123",
"match_id": "9876543210",
"price": "30000",
"qty": "0.05",
"quote_qty": "1500",
"trade_index": 0
}
]
}
}