# 获取订阅状态

# query_subscription

query_subscription(is_all_conn=True)

  • 介绍

    获取订阅信息

  • 参数

    参数 类型 说明
    is_all_conn bool 是否返回所有连接的订阅状态
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data dict 当 ret == RET_OK,返回订阅信息数据
    str 当 ret != RET_OK,返回错误描述
    • 订阅信息数据字典格式如下:

        {
            'total_used': 4,    # 所有连接已使用的订阅额度
            'own_used': 0,       # 当前连接已使用的订阅额度
            'remain': 496,       #  剩余的订阅额度
            'sub_list':          #  每种订阅类型对应的股票列表
            {
                '订阅的类型': 该订阅类型下所有已订阅股票列表,
                …
            }
        }
      
  • Example

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

quote_ctx.subscribe(['HK.00700'], [SubType.QUOTE])
ret, data = quote_ctx.query_subscription()
if ret == RET_OK:
    print(data)
else:
    print('error:', data)
quote_ctx.close() # 结束后记得关闭当条连接,防止连接条数用尽
1
2
3
4
5
6
7
8
9
10
  • Output
{'total_used': 1, 'remain': 999, 'own_used': 1, 'sub_list': {'QUOTE': ['HK.00700']}}
1