修改订单
修改订单的价格、数量或触发价格。对于触发订单,如果订单已经被触发,触发价格将无法进一步修改。修订订单不适用于算法订单。
请求参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 市场符号 |
| orderID | String | 否 | 内部订单 ID。当未提供 clOrderID 时为必填项。如果提供了 orderID,将忽略 clOrderID。 |
| clOrderID | String | 否 | 自定义订单 ID。当未提供 orderID 时为必填项。 |
| type | String | 是 | 修改类型:PRICE(修改订单价格)、SIZE(修改订单大小)、TRIGGERPRICE(修改触发价格,仅适用于触发单)、ALL(修改多个字段) |
| value | Double | 否 | 要修改的新值。PRICE、SIZE 或 TRIGGERPRICE 修改类型时为必填项 |
| orderPrice | Double | 否 | 对于类型 ALL — 要修改的订单价格 |
| orderSize | Integer | 否 | 对于类型 ALL — 要修改的合同大小订单尺寸 |
| triggerPrice | Double | 否 | 对于类型 ALL — 要修改的触发价格 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| symbol | String | 市场符号 |
| orderID | String | 订单 ID |
| clOrderID | String | 交易者发送的客户标签 |
| orderType | Integer | 订单类型:76(限价订单)· 77(市价订单)· 80(Algo 订单) |
| side | String | 交易方向: [BUY, SELL] |
| price | Double | 订单价格 |
| status | Integer | 订单状态:2(订单已插入)· 4(完全成交)· 5(部分成交)· 6(已取消)· 9(触发已插入)· 10(触发已激活)· 15(已拒绝) |
| time_in_force | String | 订单有效期:GTC · IOC · FOK · HALFMIN · FIVEMIN · HOUR · TWELVEHOUR · DAY · WEEK · MONTH |
| timestamp | Long | 订单时间戳 |
| trigger | Boolean | 如果订单是触发订单的指示器 |
| triggerPrice | Double | 订单触发价格,如果订单不是触发订单则返回 0 |
| avgFilledPrice | Double | 平均成交价格。对于部分交易的订单返回平均成交价格 |
| message | String | 交易消息 |
| stealth | Double | 仅对 Algo 订单有效 |
| deviation | Double | 仅对 Algo 订单有效 |
| remainingSize | Integer | 剩余订单数量 = 当前订单数量 - 已成交数量 |
| originalOrderSize | Integer | 原始订单数量。即使后续有调整,此值也不会变化 |
| currentOrderSize | Integer | 当前最新的订单数量,表示已成交数量与未成交剩余数量的总和 |
| filledSize | Integer | 订单已成交的数量 |
| totalFilledSize | Integer | 该订单的累计成交数量 |
| postOnly | Boolean | 表明订单是否为只做 Maker(Post only)订单 |
| positionMode | String | 仓位模式:单向持仓 ONE_WAY 或双向持仓 HEDGE 或逐仓保证金模式 ISOLATED |
| positionDirection | String | 仓位方向:多头仓位 LONG 或空头仓位 SHORT |
| positionId | String | 当前订单属于的仓位 ID |
example
PUT
https://api.btse.com/futures/api/v2.3/orderRequest (修改价格)
{
"symbol": "BTC-PERP",
"orderID": "25248336-66d8-41ff-99fd-83489c4e6029",
"type": "PRICE",
"value": 35000
}
Request (修改大小)
{
"symbol": "BTC-PERP",
"orderID": "689bf733-4879-4e32-8d1f-cb81f63d24d4",
"type": "SIZE",
"value": 5
}
Request (修改多个字段)
{
"symbol": "BTC-PERP",
"orderID": "cb2785b0-558e-4b30-bf1f-8a8c56174d0c",
"type": "ALL",
"orderPrice": 40010,
"orderSize": 5,
"triggerPrice": 40000
}