跳到主要内容
版本:V2

订单频道

描述

订阅订单频道

请求参数

参数名参数类型是否必须描述
eventString操作, subscribe unsubscribe
channelString频道名

请求示例

{
"event": "subscribe",
"channel": "orders"
}

返回参数

返回字段参数类型字段说明
eventString操作, subscribed unsubscribed
channelString频道名

订阅返回示例

{
"event": "subscribed",
"channel": "orders"
}

推送数据参数

返回字段参数类型字段说明
idString订单id。取值大于0
symbolNameString币对名
baseCoinString交易币种
quoteCoinString计价币种
orderSideString买卖方向
priceString委托价格(最差可接受的价格)
sizeString委托数量
valueString委托价值
clientOrderIdString客户自定义id,用于幂等校验
typeString委托单类型
timeInForceString委托单执行策略。type为 LIMIT/STOP_LIMIT/TAKE_PROFIT_LIMIT 时有意义
reduceOnlyString是否是只减仓委托
triggerPriceString触发价格。type为 STOP_LIMIT/STOP_MARKET/TAKE_PROFIT_LIMIT/TAKE_PROFIT_MARKET 时有意义。如果为0代表字段为空。
orderSourceString订单来源
openTpslParentOrderIdString开仓止盈单,止损单的开仓单orderId
isSetOpenTpString是否设置开仓止盈
openTpParamString开仓止盈参数
isSetOpenSlString是否设置开仓止损
openSlParamString开仓止损参数
takerFeeRateString下单时taker手续费率
makerFeeRateString下单时maker手续费率
feeDiscountString下单时手续费折扣率
liquidateFeeRateString下单时清算手续费率
statusString委托单状态
triggerTimeString条件单触发时间
triggerPriceTimeString条件单触发价格时间
triggerPriceValueString条件单触发价格值
cancelReasonString委托单取消原因
latestFillPriceString当前委托单最新成交价格
maxFillPriceString当前委托单最高成交价格
minFillPriceString当前委托单最低成交价格
cumFillSizeString累计撮合后成交数量
cumFillValueString累计撮合后成交价值
cumFillFeeString累计撮合后成交手续费
createdTimeString创建时间
updatedTimeString更新时间

推送返回示例

{
"type": "trade-event",
"msg": {
"msgEvent": "OrderUpdate",
"version": 38,
"data": {
"order": [
{
"id": "625138763307155610",
"symbolName": "BTCUSDT_SPBL",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"orderSide": "BUY",
"price": "0",
"size": "0",
"value": "100.0000000",
"clientOrderId": "1749044695347g1xrdKa2xuDzbDHgTTkbubUoRd3x7s9c2I2mdtdj5qt7M6Evz5m",
"type": "MARKET",
"timeInForce": "IMMEDIATE_OR_CANCEL",
"reduceOnly": false,
"triggerPrice": "0",
"orderSource": "UNKNOWN_ORDER_SOURCE",
"openTpslParentOrderId": "0",
"isSetOpenTp": false,
"isSetOpenSl": false,
"takerFeeRate": "0.001",
"makerFeeRate": "0",
"feeDiscount": "1",
"takerFeeDiscount": "1",
"makerFeeDiscount": "1",
"status": "FILLED",
"triggerTime": "0",
"triggerPriceTime": "0",
"triggerPriceValue": "0",
"cancelReason": "UNKNOWN_ORDER_CANCEL_REASON",
"latestFillPrice": "105008.0",
"maxFillPrice": "105008.0",
"minFillPrice": "105008.0",
"cumFillSize": "0.000952",
"cumFillValue": "99.9676160",
"cumFillFee": "0.00000095",
"createdTime": "1749044695689",
"updatedTime": "1749044695720"
}
]
},
"time": 1749044695720
},
"channel": "orders",
"event": "payload"
}