標的事件

接收標的屬性變更通知，包括：

• 交易權限變更（可交易/僅限平倉/不可交易）
• 可融券狀態變更（可融券/不可融券）
• 融資融券狀態變更
• ETF 屬性變更（加密貨幣 ETF、槓桿 ETF 等）

交易屬性變更事件

當標的的交易相關屬性更新時觸發此事件。

事件結構

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "INSTRUMENT",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200Z",
    "payload": {
        "instrument_id": "10152734329",
        "status": "NT",
        "shortable": "true",
        "marginable": "true",
        "biz_type": "PROPERTY_CHANGE"
    }
}

響應欄位

欄位	類型	描述
id	string	唯一事件標識符
position	string	游標用於事件重播；重新推送當前業務類型後續事件。
event_type	string	事件類型，固定為 INSTRUMENT
timestamp	string	事件時間戳，ISO 8601 格式
payload	object	事件負載數據

Payload 欄位

欄位	類型	描述
instrument_id	string	唯一標的標識符
status	string	交易狀態： - OC：可交易 - CO：僅限平倉 - NT：不可交易
shortable	string	是否可融券：true / false
marginable	string	是否支援融資融券：true / false
biz_type	string	業務類型，固定為 PROPERTY_CHANGE

狀態值

交易狀態（status）值：

值	描述
OC	可交易 - 標的可以正常買賣
CO	僅限平倉 - 只能賣出現有持倉，不能開新倉
NT	不可交易 - 不允許任何交易操作

使用場景

監聽此事件可用於：

1. 交易權限監控：實時獲取標的交易權限變更，並相應更新 UI 顯示
2. 融券狀態追蹤：監控可融券狀態變化，調整交易策略
3. 風險管理：根據保證金要求變化調整持倉和風險控制

---

基本屬性變更事件

當標的的基本屬性（如 ETF 屬性）更新時觸發此事件。

事件結構

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "INSTRUMENT",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200Z",
    "payload": {
        "instrument_id": "10152734329",
        "crypto_etf": "false",
        "etf_leveraged_flag": "YES",
        "etf_leveraged_factor": "-1.0",
        "single_stock_etf": "false",
        "inverse_etf": "false",
        "biz_type": "BASIC_PROPERTY_CHANGE"
    }
}

響應欄位

欄位	類型	描述
id	string	唯一事件標識符
position	string	游標用於事件重播；重新推送當前業務類型後續事件。
event_type	string	事件類型，固定為 INSTRUMENT
timestamp	string	事件時間戳，ISO 8601 格式
payload	object	事件負載數據

Payload 欄位

欄位	類型	描述
instrument_id	string	唯一標的標識符
crypto_etf	string	是否為加密貨幣 ETF：true / false。非 ETF 時為空
etf_leveraged_flag	string	是否為槓桿 ETF：YES / NO。非 ETF 時為空
etf_leveraged_factor	string	ETF 槓桿倍數。非 ETF 時為空。反向 ETF 時為負數，正向為正數
single_stock_etf	string	是否為單一股票 ETF：true / false。非 ETF 時為空
inverse_etf	string	是否為反向 ETF：true / false。非 ETF 時為空
biz_type	string	業務類型，固定為 BASIC_PROPERTY_CHANGE

使用場景

監聽此事件可用於：

1. ETF 產品監控：追蹤 ETF 特定屬性的更新
2. 風險分類：識別高風險產品，如槓桿或反向 ETF
3. 產品篩選：根據 ETF 特性（加密貨幣 ETF、單一股票 ETF 等）篩選標的
4. 投資策略：根據槓桿倍數和 ETF 類型調整策略