# 获取事件合约逐笔

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