# 獲取事件合約逐筆

get_event_contract_ticker(code, count=30)

  • 介紹

    獲取單只事件合約的即時逐筆成交數據,包含成交時間、YES/NO 成交價、成交量與逐筆方向(YES/NO)。查詢逐筆前需先訂閱 SubType.TICKER,否則返回錯誤。

  • 參數

    參數 類型 說明
    code str 事件合約代碼,例如 'EC.KXODIMATCH-26JUL140600INDENG-IND'
    count int 返回條數,預設 30,最大 1000
  • 返回

    參數 類型 說明
    ret RET_CODE 介面調用結果
    data pd.DataFrame 當 ret == RET_OK,返回逐筆列表
    str 當 ret != RET_OK,返回錯誤描述

    返回的 DataFrame 欄位如下:

    欄位 類型 說明
    code str 合約代碼
    time str 成交時間(yyyy-MM-dd HH:mm:ss,不保留毫秒)
    yes_price float YES 成交價格
    no_price float NO 成交價格
    volume float 成交數量
    side str 成交方向,取值參見 PredSideYES/NO),區別於交易買賣方向
    sequence str 逐筆序號(後台大整數)
  • Example

from moomoo import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

# 查詢逐筆前需先訂閱 TICKER 類型(否則返回錯誤)
ret, err = quote_ctx.subscribe_event_contract(
    ['EC.KXODIMATCH-26JUL140600INDENG-IND'], [SubType.TICKER]
)
if ret != RET_OK:
    print('訂閱失敗:', err)
else:
    ret, data = quote_ctx.get_event_contract_ticker(
        'EC.KXODIMATCH-26JUL140600INDENG-IND', count=5
    )
    if ret == RET_OK:
        print(data)
    else:
        print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
  • Output
                                  code                 time  yes_price  no_price  volume side             sequence
0  EC.KXODIMATCH-26JUL140600INDENG-IND  2026-07-14 14:00:22        0.0      0.01    7.57   NO  7662445088852672512
1  EC.KXODIMATCH-26JUL140600INDENG-IND  2026-07-14 14:00:33        0.0      0.01   14.18   NO  7662445136097312768
2  EC.KXODIMATCH-26JUL140600INDENG-IND  2026-07-14 14:00:50        0.0      0.01  106.14   NO  7662445209111756800
3  EC.KXODIMATCH-26JUL140600INDENG-IND  2026-07-14 14:00:59        0.0      0.01    5.82   NO  7662445247766462464
4  EC.KXODIMATCH-26JUL140600INDENG-IND  2026-07-14 14:01:01        0.0      0.01  111.50   NO  7662445256356397056
1
2
3
4
5
6