跳至主要内容

帳務調撥事件

為便於第三方系統即時取得帳務調撥（資金／持倉）結果，Broker OpenAPI 支援對 帳務調撥（資金／持倉）相關操作的非同步事件主動推送機制。

當帳務調撥操作（資金/持倉）狀態發生變更時，系統將透過事件推送方式，已訂閱的用戶端將接收到最終或中間的執行結果。

資金調撥​

資金調撥事件通知

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "JOURNAL",
    "timestamp": "2025-03-29T07:02:33.200962333Z",
    "payload": {
        "from_account": "93IUJ28O9VO2KBGHDHR4H9",
        "to_account": "41IO9QG4M5O65B0EA4LSJ4UJ99",
        "client_request_id": "LJIS16BACHQG9LPP44L9IQHGAB",
        "journal_id": "89JGKD4LKIVI5UU6L3KHNU10IA",
        "journal_type": "CASH",
        "amount": "100",
        "currency": "USD",
        "status": "CANCELED",
        "reason": "xxxxxx",
        "biz_type": "CASH_JOURNAL"
    }
}

響應欄位​

字段類型描述
idstring唯一事件識別碼
event_typestring事件類型，固定為 JOURNAL
timestampstringISO 8601 格式的事件時間戳記
payloadobject事件有效負載資料

載荷欄位​

字段類型描述
from_accountstring來源帳號 ID。
to_accountstring目標帳號 ID。
client_request_idstring客戶端請求 ID，每個請求唯一。
journal_idstring系統產生的請求 ID。
journal_typestring日記帳類型，固定為 CASH
amountstring金額
currencystring貨幣，請參閱 查詢資金調撥 API 回應中的 currency 欄位。
statusstring請求狀態，請參閱 查詢資金調撥 API 回應中的 status 欄位。
reasonstring原因。如果最終狀態不是“COMPLETED”，則傳回原因。
biz_typestring業務類型，固定為 CASH_JOURNAL

持倉調撥​

持倉調撥事件通知

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "JOURNAL",
    "timestamp": "2025-03-29T07:02:33.200962333Z",
    "payload": {
        "from_account": "93IUJ28O9VO2KBGHDHR4H9",
        "to_account": "41IO9QG4M5O65B0EA4LSJ4UJ99",
        "client_request_id": "LJIS16BACHQG9LPP44L9IQHGAB",
        "journal_id": "89JGKD4LKIVI5UU6L3KHNU10IA",
        "journal_type": "POSITION",
        "instrument_type": "EQUITY",
        "market": "US",
        "symbol": "BULL",
        "quantity": "100",
        "status": "CANCELED",
        "reason": "xxxxxx",
        "biz_type": "POSITION_JOURNAL"
    }
}

響應欄位​

字段類型描述
idstring唯一事件識別碼
event_typestring事件類型，固定為 JOURNAL
timestampstringISO 8601 格式的事件時間戳記
payloadobject事件有效載荷資料

載荷欄位​

字段類型描述
from_accountstring來源帳號 ID。
to_accountstring目標帳號 ID。
client_request_idstring客戶端請求 ID，每個請求唯一。
journal_idstring系統產生的請求 ID。
journal_typestring期刊類型，固定為 POSITION
marketstring市場代碼，指示金融工具的交易場所或監管區域。請參閱查詢持倉調撥 API 回應中的market欄位。
instrument_typestring與請求關聯的金融工具類型。請參閱查詢持倉調撥 API 回應中的instrument_type欄位。
symbolstring交易代號名稱。
quantitystring數量。
statusstring請求狀態。請參閱查詢持倉調撥 API 回應中的status欄位。
reasonstring原因。如果終止狀態不是“COMPLETED”，則傳回原因。
biz_typestring業務類型固定為 POSITION_JOURNAL