subscribe - 行情订阅
订阅行情, 可以指定symbol, 数据滑窗大小, 以及是否需要等待全部代码的数据到齐再触发事件。
函数原型:
subscribe(symbols, frequency='1d', count=1, unsubscribe_previous=False)
参数:
参数名 | 类型 | 说明 |
---|---|---|
symbols | str or list | 订阅标的代码, 支持字串格式,如有多个代码, 中间用 , (英文逗号) 隔开, 也支持 ['symbol1', 'symbol2'] 这种列表格式 |
frequency | str | 频率, 支持 ‘tick’, ‘60s’, ‘300s’, ‘900s’ 等, 默认’1d’, 详情见股票行情数据和期货行情数据, 实时行情支持的频率 |
count | int | 订阅数据滑窗大小, 默认1 ,详情见数据滑窗 |
unsubscribe_previous | bool | 是否取消过去订阅的symbols, 默认False 不取消, 输入True 则取消所有原来的订阅。 |
返回值:
None
示例:
subscribe(symbols='SHSE.600000,SHSE.600004', frequency='60s', count=5, unsubscribe_previous=True)
注意:
subscribe支持多次调用,并可以重复订阅同一代码。订阅后的数据储存在本地,需要通过context.data接口调用或是直接在on_tick或on_bar中获取。
在实时模式下,最新返回的数据是不复权的。
unsubscribe - 取消订阅
取消行情订阅, 默认取消所有已订阅行情
函数原型:
unsubscribe(symbols='*', frequency='60s')
参数:
参数名 | 类型 | 说明 |
---|---|---|
symbols | str or list | 标的代码, 支持字串格式,如果有多个代码, 中间用 , (英文逗号) 隔开;* 表示所有, 默认退订所有代码 也支持 ['symbol1', 'symbol2'] 这种列表格式的参数 |
frequency | str | 频率, 支持 ‘tick’, ‘60s’, ‘300s’, ‘900s’ 等, 默认’1d’, 详情见股票行情数据和期货行情数据, 实时行情支持的频率 |
返回值:
None
示例:
unsubscribe(symbols='SHSE.600000,SHSE.600004', frequency='60s')
注意:
如示例所示代码,取消SHSE.600000,SHSE.600004
两只代码60s
行情的订阅,若SHSE.600000
同时还订阅了"300s"
频度的行情,该代码不会取消该标的此频度的订阅