PDF下载 下载

subscribe - 行情订阅

订阅行情, 可以指定symbol, 数据滑窗大小, 以及是否需要等待全部代码的数据到齐再触发事件。

函数原型:

  1. subscribe(symbols, frequency='1d', count=1, wait_group=False, wait_group_timeout='10s', unsubscribe_previous=False)

参数:

参数名 类型 说明
symbols str or list 订阅标的代码, 支持字串格式,如有多个代码, 中间用 , (英文逗号) 隔开, 也支持 ['symbol1', 'symbol2'] 这种列表格式
frequency str 频率, 支持 ‘tick’, ‘1d’, ‘15s’, ‘30s’ 等, 默认 ‘1d’, 详情见股票行情数据期货行情数据
count int 订阅数据滑窗大小, 默认1 ,详情见数据滑窗
wait_group bool 是否需要等待全部代码的数据到齐再触发事件, 默认False不到齐。设置为True则等待订阅标的eob相同的bar全部到齐再被调用。该参数只对Bar数据有效。
wait_group_timeout str 超时时间设定, 支持s结尾表示单位, 默认10s
unsubscribe_previous bool 是否取消过去订阅的symbols, 默认False不取消, 输入True则取消所有原来的订阅。

返回值:

None

示例:

  1. subscribe(symbols='SHSE.600000,SHSE.600004', frequency='tick', count=5, wait_group=True, wait_group_timeout='6s', unsubscribe_previous=True)

注意:

subscribe支持多次调用,并可以重复订阅同一代码。

unsubscribe - 取消订阅

取消行情订阅, 默认取消所有已订阅行情

函数原型:

  1. unsubscribe(symbols='*', frequency='1d')

参数:

参数名 类型 说明
symbols str or list 标的代码, 支持字串格式,如果有多个代码, 中间用 , (英文逗号) 隔开;*表示所有, 默认退订所有代码
也支持 ['symbol1', 'symbol2'] 这种列表格式的参数
frequency str 频率, 支持 ‘tick’, ‘1d’, ‘15s’, ‘30s’ 等, 默认’1d’, 详情见股票行情数据期货行情数据

返回值:

None

示例:

  1. unsubscribe(symbols='SHSE.600000,SHSE.600004', frequency='tick')

注意:
如示例所示代码,取消SHSE.600000,SHSE.600004两只代码tick行情的订阅,若SHSE.600000同时还订阅了"60s"频度的行情,该代码不会取消该标的此频度的订阅

0 篇笔记