跳到主要内容

修改订单

修改订单的价格、数量或触发价格。对于触发订单,如果订单已经被触发,触发价格将无法进一步修改。修订订单不适用于算法订单。

请求参数

名称类型是否必填描述
symbolString市场符号
orderIDString内部订单 ID。当未提供 clOrderID 时为必填项。如果提供了 orderID,将忽略 clOrderID。
clOrderIDString自定义订单 ID。当未提供 orderID 时为必填项。
typeString修改类型:PRICE(修改订单价格)、SIZE(修改订单大小)、TRIGGERPRICE(修改触发价格,仅适用于触发单)、ALL(修改多个字段)
valueDouble要修改的新值。PRICESIZETRIGGERPRICE 修改类型时为必填项
orderPriceDouble对于类型 ALL — 要修改的订单价格
orderSizeInteger对于类型 ALL — 要修改的合同大小订单尺寸
triggerPriceDouble对于类型 ALL — 要修改的触发价格

响应内容

名称类型描述
symbolString市场符号
orderIDString订单 ID
clOrderIDString交易者发送的客户标签
orderTypeInteger订单类型:76(限价订单)· 77(市价订单)· 80(Algo 订单)
sideString交易方向: [BUY, SELL]
priceDouble订单价格
statusInteger订单状态:2(订单已插入)· 4(完全成交)· 5(部分成交)· 6(已取消)· 9(触发已插入)· 10(触发已激活)· 15(已拒绝)
time_in_forceString订单有效期:GTC · IOC · FOK · HALFMIN · FIVEMIN · HOUR · TWELVEHOUR · DAY · WEEK · MONTH
timestampLong订单时间戳
triggerBoolean如果订单是触发订单的指示器
triggerPriceDouble订单触发价格,如果订单不是触发订单则返回 0
avgFilledPriceDouble平均成交价格。对于部分交易的订单返回平均成交价格
messageString交易消息
stealthDouble仅对 Algo 订单有效
deviationDouble仅对 Algo 订单有效
remainingSizeInteger剩余订单数量 = 当前订单数量 - 已成交数量
originalOrderSizeInteger原始订单数量。即使后续有调整,此值也不会变化
currentOrderSizeInteger当前最新的订单数量,表示已成交数量与未成交剩余数量的总和
filledSizeInteger订单已成交的数量
totalFilledSizeInteger该订单的累计成交数量
postOnlyBoolean表明订单是否为只做 Maker(Post only)订单
positionModeString仓位模式:单向持仓 ONE_WAY 或双向持仓 HEDGE 或逐仓保证金模式 ISOLATED
positionDirectionString仓位方向:多头仓位 LONG 或空头仓位 SHORT
positionIdString当前订单属于的仓位 ID
example
PUThttps://api.btse.com/futures/api/v2.3/order

Request (修改价格)

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