跳到主要内容

通知

WSProductionwss://ws.btse.com/ws/spotTestnetwss://testws.btse.io/ws/spot

实时订单状态更新。需要 WebSocket 身份验证。 主题: notificationApiV3

新增基础与计价币种两套数量字段(originalOrderBaseSizeoriginalOrderQuoteSizecurrentOrderBaseSizecurrentOrderQuoteSizefilledBaseSizetotalFilledBaseSizeremainingBaseSizeremainingQuoteSize),以便完整表示以计价币种下单的市价单。

响应内容

名称类型是否必填描述
topicString
dataObject数据对象

Data 对象:

名称类型是否必填描述
symbolString市场交易对
orderIDString内部订单 ID
sideString成交方向(BUY 或 SELL)
orderTypeInteger订单类型 — 76:限价单 · 77:市价单 · 80:策略/算法单
txTypeInteger交易类型 — 0:LIMIT · 1:STOP · 2:TRIGGER · 3:OCO
priceDouble委托价或成交价
triggerPriceDouble条件单触发价格
pegPriceDeviationDouble价格偏差百分比(仅算法单)
stealthDouble订单簿上的可见比例(仅算法单)
statusInteger订单状态码 — 1(市场不可用)· 2(订单已插入)· 4(完全成交)· 5(部分成交)· 6(已取消)· 8(余额不足)· 9(触发已插入)· 10(触发已激活)· 12(更新风险限额失败)· 15(已拒绝)· 27(划转成功)· 28(划转失败)· 41(无效风险限额)· 64(账户清算中)· 101(合约委托价超出清算价)· 1003(订单清算中)· 1004(订单 ADL 中)
timestampLong订单或成交时间戳(毫秒)
avgFilledPriceDouble平均成交价
clOrderIDString自定义订单 ID
makerBoolean是否为 maker 成交
postOnlyBoolean是否为只挂单(不主动撮合)
orderUserInitiatedBoolean手动下单(true)或自动下单(false)
originalOrderBaseSizeDouble原始基础币种数量
originalOrderQuoteSizeDouble原始计价币种数量
currentOrderBaseSizeDouble当前基础币种数量
currentOrderQuoteSizeDouble当前计价币种数量
filledBaseSizeDouble本次事件成交的基础币种数量
totalFilledBaseSizeDouble累计已成交的基础币种数量
remainingBaseSizeDouble剩余未成交的基础币种数量
remainingQuoteSizeDouble剩余未成交的计价币种数量
orderCurrencyString下单计量币种(basequote
time_in_forceString订单有效期:GTC · IOC · FOK · HALFMIN · FIVEMIN · HOUR · TWELVEHOUR · DAY · WEEK · MONTH
example

Response

{
"topic": "notificationApiV3",
"data": {
"symbol": "BTC-USDT",
"orderID": "789b05fa-dd43-43e8-8626-e229ae216ead",
"side": "BUY",
"orderType": 77,
"txType": 0,
"price": 111131,
"triggerPrice": 0,
"pegPriceDeviation": 1,
"stealth": 1,
"status": 5,
"timestamp": 1752147703368,
"avgFilledPrice": 111131,
"clOrderID": "_W_bjvf1752147703280",
"maker": false,
"postOnly": false,
"orderUserInitiated": true,
"originalOrderBaseSize": 0,
"originalOrderQuoteSize": 1000,
"currentOrderBaseSize": 0,
"currentOrderQuoteSize": 1000,
"filledBaseSize": 0.00899,
"totalFilledBaseSize": 0.00899,
"remainingBaseSize": 0,
"remainingQuoteSize": 0.93231,
"orderCurrency": "quote",
"time_in_force": "GTC"
}
}