关于API将新增两个Websocket订阅主题的公告

尊敬的用户：

自本通知生效之日起，火币Global将新增以下Websocket订阅主题 –
1） 清算后成交明细推送 trade.clearing#${symbol}
2） 账户变更推送 accounts.update#${mode}

生效日期：2019年11月29日（GMT+8）
具体变更细节及参数要求，请参考API文档：https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2019年11月22日

以下为变更细节：

订阅主题trade.clearing#${symbol}

清算后成交明细包含了交易手续费以及交易手续费抵扣等信息，仅当用户订单成交时推送。

请求参数	数据类型	描述
symbol	string	交易代码（支持通配符”*”）

数据更新字段列表

字段名称	数据类型	描述
symbol	string	交易代码
orderId	long	订单ID
tradePrice	string	成交价
tradeVolume	string	成交量
orderSide	string	订单方向，有效值： buy, sell
orderType	string	订单类型，有效值： buy-market, sell-market,buy-limit,sell-limit,buy-ioc,sell-ioc,buy-limit-maker,sell-limit-maker,buy-stop-limit,sell-stop-limit
aggressor	bool	是否交易主动方，有效值： true, false
tradeId	long	交易ID
tradeTime	long	成交时间，unix time in millisecond
transactFee	string	交易手续费
feeDeduct	string	交易手续费抵扣
feeDeductType	string	交易手续费抵扣类型，有效值： ht，point

订阅
{
    "action": "sub",
    "ch": "trade.clearing#btcusdt"
}

订阅响应：
{
    "action": "sub",
    "code": 200,
    "ch": "trade.clearing#btcusdt",
    "data": {}
}

数据推送：
{
    "ch": "trade.clearing#btcusdt",
    "data": {
        "symbol": "btcusdt",
        "orderId": 99998888,
        "tradePrice": "9999.99",
        "tradeVolume": "0.96",
        "orderSide": "buy",
        "aggressor": true,
        "tradeId": 919219323232,
        "tradeTime": 998787897878,
        "transactFee": "19.88",
        " feeDeduct ": "0",
        " feeDeductType": ""
    }
}

订阅主题accounts.update#${mode}

用户可选择以下任一账户变更推送的触发方式 –
1） 仅在账户余额发生变动时推送；
2） 在账户余额发生变动或可用余额发生变动时均推送，且分别推送。

请求参数	数据类型	描述
mode	integer	推送方式，有效值：0, 1，默认值：00：仅当账户余额变动时推送1：在账户余额发生变动或可用余额发生变动时均推送且分别推送

订阅示例 –
1） 不填mode：
accounts.update
仅当账户余额变动时推送；
2） 填写mode=0：
accounts.update#0
仅当账户余额变动时推送；
3） 填写mode=1：
accounts.update#1
在账户余额发生变动或可用余额发生变动时均推送且分别推送。

数据更新字段列表

字段名称	数据类型	描述
currency	string	币种
accountId	long	账户ID
balance	string	账户余额（仅当账户余额发生变动时推送）
available	string	可用余额（仅当可用余额发生变动时推送）
changeType	string	余额变动类型，有效值：order-place(订单创建)，order-match(订单成交)，order-refund(订单成交退款)，order-cancle(订单撤销)，order-fee-refund(点卡抵扣交易手续费)，margin-transfer(杠杆账户划转)，margin-loan(借贷本金)，margin-interest(借贷计息)，margin-repay(归还借贷本金利息)，other(其他资产变化)
accountType	string	账户类型，有效值：trade, frozen, loan, interest
changeTime	long	余额变动时间，unix time in millisecond

订阅
{
     "action": "sub",
     "ch": "accounts.update"
}

订阅响应：
{
     "action": "sub",
     "code": 200,
     "ch": "accounts.update#0",
     "data": {}
}

数据推送：
accounts.update#0：
{
     "action": "push",
     "ch": "accounts.update#0",
     "data": {
        "currency": "btc",
        "accountId": 123456,
        "balance": "23.111",
        "changeType": "transfer",
            "accountType":"trade",
        "changeTime": 1568601800000
    }
}

accounts.update#1：
{
    "action": "push",
    "ch": "accounts.update#1",
    "data": {
        "currency": "btc",
        "accountId": 33385,
        "available": "2028.699426619837209087",
        "changeType": "order.match",
            "accountType":"trade",
        "changeTime": 1574393385167
    }
}
{
    "action": "push",
    "ch": "accounts.update#1",
    "data": {
        "currency": "btc",
        "accountId": 33385,
        "balance": "2065.100267619837209301",
        "changeType": "order.match",
            "accountType":"trade",
        "changeTime": 1574393385122
    }
}