# 事件合约接口总览
事件合约（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 组合询价 | ||