跳至主要内容

帳戶事件

接收帳戶相關事件通知，包括：

  • 帳戶限制和狀態變更
  • 虛擬帳戶（VA）BCAN 碼審批狀態變更
  • 帳戶關閉處理

帳戶更新事件​

當 Omni 級別帳戶的限制或狀態變更時觸發此事件。

事件結構​

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "ACCOUNT",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200Z",
    "payload": {
        "account_id": "036UUF6TQA8CD0KHJPEC000000",
        "account_number": "5KT05001",
        "account_type": "CASH",
        "restrictions": [
            "HK_STOCK_NO_TRADE",
            "HK_STOCK_LIQUIDATE_ONLY",
            "US_STOCK_NO_TRADE",
            "US_STOCK_LIQUIDATE_ONLY",
            "CN_STOCK_LIQUIDATE_ONLY",
            "CN_STOCK_NO_TRADE"
        ],
        "update_time": "2025-03-29T07:02:33.200Z",
        "biz_type": "ACCOUNT_UPDATE"
    }
}

響應欄位​

欄位類型描述
idstring唯一事件標識符
positionstring游標用於事件重播；重新推送當前業務類型後續事件。
event_typestring事件類型，固定為 ACCOUNT
timestampstring事件時間戳，ISO 8601 格式
payloadobject事件負載數據

Payload 欄位​

欄位類型描述
account_idstring帳戶ID
account_numberstring帳戶號碼
account_typestring帳戶類型：CASH / MARGIN
restrictionsarray當前帳戶限制陣列（完整快照）
update_timestring更新時間戳，ISO 8601 格式
biz_typestring業務類型，固定為 ACCOUNT_UPDATE

限制類型​

restrictions 陣列包含當前帳戶限制。每次推送提供所有生效限制的完整快照：

限制代碼描述
HK_STOCK_NO_TRADE港股 - 不可交易
HK_STOCK_LIQUIDATE_ONLY港股 - 僅限平倉（只能平倉）
US_STOCK_NO_TRADE美股 - 不可交易
US_STOCK_LIQUIDATE_ONLY美股 - 僅限平倉（只能平倉）
CN_STOCK_NO_TRADEA 股 - 不可交易
CN_STOCK_LIQUIDATE_ONLYA 股 - 僅限平倉（只能平倉）
資訊
  • 每次事件推送包含當前限制的完整快照，而非增量變更
  • 空的 restrictions 陣列表示帳戶當前沒有任何限制

虛擬帳戶 BCAN 更新事件​

當虛擬帳戶（VA）的 BCAN 碼審批狀態在交易所發生變更時觸發此事件。

事件結構 - 審批成功​

當交易所審批通過 BCAN 碼時，對應品類的交易權限將授予 VA 帳戶。

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "ACCOUNT",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200Z",
    "payload": {
        "account_id": "O3I8NNB882S2BK7MF1ACJ5UTK9",
        "account_number": "VA0000001",
        "account_type": "MARGIN",
        "type": "CN",
        "status": "SUCCESS",
        "update_time": "2025-03-29T07:02:33.200Z",
        "biz_type": "VIRTUAL_ACCOUNT_BCAN_UPDATE"
    }
}

響應欄位​

欄位類型描述
idstring唯一事件標識符
positionstring游標用於事件重播；重新推送當前業務類型後續事件。
event_typestring事件類型，固定為 ACCOUNT
timestampstring事件時間戳，ISO 8601 格式
payloadobject事件負載數據

Payload 欄位​

欄位類型描述
account_idstring虛擬帳戶ID
account_numberstring虛擬帳戶號碼
account_typestring帳戶類型：CASH / MARGIN
typestringBCAN 類型，目前僅支援 CN（A 股）
statusstringBCAN 狀態：SUCCESS / FAILED
update_timestring更新時間戳，ISO 8601 格式
biz_typestring業務類型，固定為 VIRTUAL_ACCOUNT_BCAN_UPDATE

BCAN 狀態值​

狀態描述
SUCCESSBCAN 碼已被交易所審批通過 - 交易權限已授予
FAILEDBCAN 碼被交易所拒絕 - 交易權限被拒絕

使用場景​

監聽這些事件可用於：

  1. 帳戶狀態監控：追蹤即時帳戶限制變更，並相應更新 UI/存取控制
  2. 交易權限管理：根據帳戶限制自動啟用或停用交易功能
  3. BCAN 狀態追蹤：監控虛擬帳戶 A 股交易的 BCAN 審批狀態
  4. 風險管理：當僅限平倉限制生效時，調整風險控制和倉位管理
  5. 客戶通知：提醒客戶注意需要關注或採取行動的帳戶狀態變更
  6. 合規監控：追蹤帳戶限制以滿足監管和合規要求