尊敬的用户：

自2020年4月3日起，火币Global将上线V2版本Websocket订单更新推送接口“orders#${symbol}”。

生效日期：2020年4月3日（GMT+8）

具体变更细节及参数要求，请参考API文档：https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年4月4日

## 订阅订单更新

API Key权限：读取

订单的更新推送由任一以下事件触发：
- 订单创建（eventType=creation）；
- 订单成交（eventType=trade）；
- 订单撤销（eventType=cancellation）。
但根据不同事件类型所推送的消息中，字段列表略有不同。

### 订阅主题

` orders#${symbol}`

### 订阅参数

> Subscribe request
```json
{
        "action": "sub",
        "ch": " orders#btcusdt"
}

```

> Response

```json
{
        "action": "sub",
        "code": 200,
        "ch": " orders#btcusdt",
        "data": {}
}
```

### 数据更新字段列表

当订单被创建后 –

注：止盈止损订单在尚未被触发时，接口将不会推送此订单的创建。仅当止盈止损订单被触发且未成交，接口才会被推送此订单的“creation”事件类型。并且，推送消息中的订单类型不再是原始订单类型“buy-stop-limit”或“sell-stop-limit”，而是变为“buy-limit”或“sell-limit”。

```json
{
"action":"push",
"ch":"orders#btcusdt",
"data":
{
        "orderSize":"2.000000000000000000",
        "orderCreateTime":1583853365586,
        "orderPrice":"77.000000000000000000",
        "type":"sell-limit",
        "orderId":27163533,
        "clientOrderId":"a001",
        "orderStatus":"submitted",
        "symbol":"btcusdt",
        "eventType":"creation"
        }
}
```

当订单成交后 –

注：当一张taker订单同时与对手方多张订单成交后，所产生的每笔成交将被分别推送（而不是合并推送一笔）。

```json
{
        "action":"push",
        "ch":"orders#btcusdt",
        "data":
        {
        "tradePrice":"76.000000000000000000",
        "tradeVolume":"1.013157894736842100",
        "tradeId":301,
        "tradeTime":1583854188883,
        "aggressor":true,
        "execAmt":"1.013157894736842100",
        "remainAmt":"0.000000000000000400000000000000000000",
        "orderId":27163536,
        "clientOrderId":"",
        "orderStatus":"filled",
        "symbol":"btcusdt",
        "eventType":"trade"
        }
}
```

当订单被撤销后 –

```json
{
        "action":"push",
        "ch":"orders#btcusdt",
        "data":
        {
        "lastActTime":1583853475406,
        "remainAmt":"2.000000000000000000",
        "orderId":27163533,
        "clientOrderId":"a001",
        "orderStatus":"canceled",
        "symbol":"btcusdt",
        "eventType":"cancellation"
        }
}
```

对用户的影响：
API用户需自行评估此新接口上线对用户自身业务的适配，以及即将下线接口的迁移，并更新相关应用。

所有变更将自本通知生效之日起更新至 HTX API Docs。