持倉事件

為使第三方系統能夠及時獲取期權行權、指派和到期的處理結果，Broker OpenAPI 支援期權持倉相關操作的非同步事件推送機制。

當期權持倉操作狀態發生變更（行權、指派或到期）時，系統將推送事件通知，已訂閱的用戶端將收到執行結果。

行權事件

期權行權事件通知

EXERCISED

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "POSITION",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200962333Z",
    "payload": {
        "account_id": "J6HA4EBQRQFJD2J6NQH0F7M649",
        "position_id": "HLJQV6O9AVHH2JFKEBAO5PIUJ9",
        "quantity": "1",
        "symbol": "AAPL",
        "strike_price": "220.00",
        "option_expire_date": "2026-06-19",
        "instrument_type": "OPTION",
        "option_type": "CALL",
        "market": "US",
        "status": "EXERCISED",
        "biz_type": "OPTION_EXERCISE"
    }
}

指派事件

期權指派事件通知

ASSIGNED

{
    "id": "event_a8f3d120-bf41-4e2c-b712-89cd5ef12a3b",
    "event_type": "POSITION",
    "position": "CKP2gxBDHBBgCDAC",
    "timestamp": "2025-03-29T07:02:33.200962333Z",
    "payload": {
        "account_id": "J6HA4EBQRQFJD2J6NQH0F7M649",
        "position_id": "MRKWT8P3BVNN4KGL0CBQ6QIXA2",
        "quantity": "-1",
        "symbol": "AAPL",
        "strike_price": "220.00",
        "option_expire_date": "2026-06-19",
        "instrument_type": "OPTION",
        "option_type": "CALL",
        "market": "US",
        "status": "ASSIGNED",
        "biz_type": "OPTION_ASSIGNMENT"
    }
}

到期事件

期權到期事件通知

EXPIRED

{
    "id": "event_c4b2c210-ce32-41d4-a9a1-cfad4fdf191c",
    "event_type": "POSITION",
    "position": "CJO1fxACGAAgADAB",
    "timestamp": "2025-03-29T07:02:33.200962333Z",
    "payload": {
        "account_id": "J6HA4EBQRQFJD2J6NQH0F7M649",
        "position_id": "HLJQV6O9AVHH2JFKEBAO5PIUJ9",
        "quantity": "1",
        "symbol": "AAPL",
        "strike_price": "220.00",
        "option_expire_date": "2026-05-08",
        "instrument_type": "OPTION",
        "option_type": "CALL",
        "market": "US",
        "status": "EXPIRED",
        "biz_type": "OPTION_EXPIRATION"
    }
}

回應欄位

欄位	類型	描述
id	string	唯一事件識別碼
event_type	string	事件類型，固定為 POSITION
position	string	持倉識別碼
timestamp	string	事件時間戳，ISO 8601 格式
payload	object	事件酬載資料

Payload 欄位

欄位	類型	描述
account_id	string	帳戶 ID
position_id	string	系統產生的持倉 ID
quantity	string	數量。行權/到期為正數（多頭持倉），指派為負數（空頭持倉）
symbol	string	標的代碼
strike_price	string	期權行權價
option_expire_date	string	期權到期日，格式為 YYYY-MM-DD
instrument_type	string	金融工具類型，固定為 OPTION
option_type	string	期權類型：CALL（看漲）或 PUT（看跌）
market	string	市場代碼，表示金融工具的交易場所或監管區域
status	string	持倉狀態：EXERCISED（已行權）、ASSIGNED（已指派）或 EXPIRED（已到期）
biz_type	string	業務類型：OPTION_EXERCISE（行權）、OPTION_ASSIGNMENT（指派）或 OPTION_EXPIRATION（到期）