# 交易通知推送

`WS` `push · cmd 18`

`private` 主題上的訂單/成交推送。Notification 外層攜帶 JSON 負載(事件 `order_changed_lb`;網格訂單為 `gridtrading_order`)。

```protobuf
message Notification {
  string topic = 1;
  ContentType content_type = 2;
  DispatchType dispatch_type = 3;
  bytes data = 4;
}

enum ContentType { CONTENT_UNDEFINED = 0; CONTENT_JSON = 1; CONTENT_PROTO = 2; }
```

## Push Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `topic` | string | No | 主題 |
| `content_type` | int32 | No | 內容類型 (JSON/PROTO) |
| `dispatch_type` | int32 | No | 分發類型 |
| `data` | bytes | No | 推播數據（訂單變更） |
| `└ side` | string | No | 買賣方向 (Buy/Sell) |
| `└ stock_name` | string | No | 公司名稱 |
| `└ submitted_quantity` | string | No | 委託數量 |
| `└ symbol` | string | No | 訂單標的 |
| `└ order_type` | string | No | 訂單類型 |
| `└ submitted_price` | string | No | 委託價格 |
| `└ executed_quantity` | string | No | 成交數量 |
| `└ executed_price` | string | No | 成交價格 |
| `└ order_id` | string | No | 訂單 id |
| `└ currency` | string | No | 結算貨幣 |
| `└ status` | string | No | 訂單狀態 |
| `└ submitted_at` | string | No | 下單時間，格式為時間戳 (秒) |
| `└ updated_at` | string | No | 最近更新時間 |
| `└ trigger_price` | string | No | 觸發價格 |
| `└ msg` | string | No | 拒絕理由，備注信息 |
| `└ tag` | string | No | 訂單標記 (Normal/GTC/Grey) |
| `└ trigger_status` | string | No | 條件單觸發狀態 |
| `└ trigger_at` | string | No | 觸發時間 |
| `└ trailing_amount` | string | No | 條件單跟蹤金額 |
| `└ trailing_percent` | string | No | 條件單跟蹤漲跌幅 |
| `└ limit_offset` | string | No | 指定價差 |
| `└ account_no` | string | No | 用戶端賬號 |
| `└ remark` | string | No | 備注 |
| `└ last_share` | string | No | 最新成交數量 |
| `└ last_price` | string | No | 最新成交價格 |
| `└ multi_leg` | object | No | 多腿策略信息，僅多腿期權組合訂單推送 |
| ` └ strategy` | string | No | 多腿策略 |
| ` └ strategy_name` | string | No | 策略名稱 |
| ` └ multileg_id` | string | No | 多腿組合 ID |
| ` └ code` | string | No | 多腿組合代碼 |
| ` └ legs` | object[] | No | 組合訂單的各腿 |
| `  └ symbol` | string | No | 期權 symbol，使用 ticker.region 格式 |
| `  └ side` | string | No | 買賣方向 (Buy/Sell) |
| `  └ position` | string | No | 持倉方向 (LONG/SHORT) |
| `  └ ratio_quantity` | string | No | 該腿比例數量 |
| `  └ strike_price` | string | No | 行權價 |
| `  └ expire_date` | string | No | 期權到期日，格式：YYYYMMDD |
| `  └ contract_direction` | string | No | 合約類型 (C=看漲/P=看跌) |

## Response JSON Example

```json
{
  "event": "order_changed_lb",
  "data": {
    "side": "Buy",
    "stock_name": "Tencent Holdings Ltd.",
    "submitted_quantity": "1000",
    "symbol": "700.HK",
    "order_type": "LO",
    "submitted_price": "213.2",
    "executed_quantity": "1000",
    "executed_price": "213.2",
    "order_id": "27",
    "currency": "HKD",
    "status": "NewStatus",
    "submitted_at": "1562761893",
    "updated_at": "1562761893"
  }
}
```
