# 获取到价提醒列表

get_price_reminder(code=None, market=None)

  • 介绍

    获取对指定股票 / 指定市场设置的到价提醒列表

  • 参数

    参数 类型 说明
    code str 股票代码
    market Market 市场类型

    注:code 和 market 都存在的情况下,code 优先。

  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK,返回到价提醒数据
    str 当 ret != RET_OK,返回错误描述
    • 到价提醒数据格式如下:
      字段 类型 说明
      code str 股票代码
      key int 标识,用于修改到价提醒
      reminder_type PriceReminderType 到价提醒的类型
      reminder_freq PriceReminderFreq 到价提醒的频率
      value float 提醒值
      enable bool 是否启用
      note str 备注
  • Example

from futu import *
quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret, data = quote_ctx.get_price_reminder(code='HK.00700')
if ret == RET_OK:
    print(data)
    print(data['key'].values.tolist())   # 转为 list
else:
    print('error:', data)
print('******************************************')
ret, data = quote_ctx.get_price_reminder(code=None, market=Market.HK)
if ret == RET_OK:
    print(data)
    if data.shape[0] > 0:  # 如果到价提醒列表不为空
        print(data['code'][0])    # 取第一条的股票代码
        print(data['code'].values.tolist())   # 转为 list
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
  • Output
    code                key       reminder_type  reminder_freq  value  enable      note
0   HK.00700  158441340870842901      PRICE_UP        ALWAYS    382.4   False   10:50:04
1   HK.00700  158573111208632201    PRICE_DOWN        ALWAYS    370.0    True         

[6 rows x 7 columns]
[158441340870842901, 158573111208632201]
******************************************
    code              key          reminder_type  reminder_freq   value  enable      note
0   HK.00700   158441340870842901      PRICE_UP        ALWAYS    382.4   False    10:50:04
1   HK.00700   158573111208632201    PRICE_DOWN        ALWAYS    370.0    True
2   HK.HSImain  158573100205367801    PRICE_DOWN        ALWAYS  22900.0    True         

[12 rows x 7 columns]
HK.00700
['HK.00700', 'HK.00700', 'HK.HSImain']
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

接口限制

  • 每 30 秒内最多请求 10 次获取到价提醒列表接口