# 事件合約介面總覽
事件合約（Event Contract）是針對未來事件（如選舉、經濟數據、賽事）的預測合約，按 YES/NO（二元）方向交易。完整呼叫鏈：分類 → 賽事篩選 → Series → Event → Contract → 快照 / 訂閱盤口·K線·逐筆。
| 模組 | 介面名 | 功能簡介 | |
|---|---|---|---|
| 訂閱 | subscribe_event_contract | 訂閱事件合約實時數據，指定合約代碼與數據類型即可 | |
| unsubscribe_event_contract | 按合約、類型、K 線來源精確取消訂閱 | ||
| unsubscribe_all_event_contract | 取消當前連接所有事件合約訂閱 | ||
| 實時行情 | get_event_contract_snapshot | 批量取得事件合約實時快照（最新價、累計成交量、YES/NO 買賣一檔等） | |
| get_event_contract_order_book | 取得事件合約實時擺盤（多檔 YES/NO 買賣盤），需先訂閱 ORDER_BOOK | ||
| EventContractOrderBookHandlerBase | 事件合約擺盤推送回調 | ||
| get_event_contract_kline | 取得事件合約實時 K 線，需先訂閱對應 K 線類型 | ||
| EventContractKlineHandlerBase | 事件合約 K 線推送回調 | ||
| get_event_contract_ticker | 取得事件合約實時逐筆，需先訂閱 TICKER | ||
| EventContractTickerHandlerBase | 事件合約逐筆推送回調 | ||
| request_history_event_contract_kline | 拉取事件合約歷史 K 線 | ||
| 發現 | filter_competition | 賽事篩選，取得賽事與玩法 | |
| get_event_contract_category | 取得事件合約分類列表 | ||
| get_event_contract_series_list | 按分類取得 Series 列表 | ||
| get_event_contract_event_list | 按 Series 取得 Event 列表 | ||
| get_event_contract | 按 Event 取得合約（Contract）列表，含推薦合約 | ||
| get_event_contract_milestone_list | 取得里程碑列表 | ||
| get_valid_combo_list | 取得可組合（Combo）的事件列表 | ||
| request_combo_quotes | Combo 組合詢價 | ||