# 获取证券关联数据

# get_referencestock_list

get_referencestock_list(code, reference_type)

  • 介绍

    获取证券的关联数据,如:获取正股相关窝轮、获取期货相关合约

  • 参数

    参数 类型 说明
    code str 证券代码
    reference_type SecurityReferenceType 要获得的相关数据
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK,返回证券的关联数据
    str 当 ret != RET_OK,返回错误描述
    • 证券的关联数据格式如下:
      字段 类型 说明
      code str 证券代码
      lot_size int 每手股数,期货表示合约乘数
      stock_type SecurityType 证券类型
      stock_name str 证券名字
      list_time str 上市时间
      wrt_valid bool 是否是窝轮
      wrt_type WrtType 窝轮类型
      wrt_code str 所属正股
      future_valid bool 是否是期货
      future_main_contract bool 是否主连合约
      future_last_trade_time str 最后交易时间
  • Example

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

# 获取正股相关的窝轮
ret, data = quote_ctx.get_referencestock_list('HK.00700', SecurityReferenceType.WARRANT)
if ret == RET_OK:
    print(data)
    print(data['code'][0])    # 取第一条的股票代码
    print(data['code'].values.tolist())   # 转为 list
else:
    print('error:', data)
print('******************************************')
# 港期相关合约
ret, data = quote_ctx.get_referencestock_list('HK.A50main', SecurityReferenceType.FUTURE)
if ret == RET_OK:
    print(data)
    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
20
21
  • Output
        code  lot_size stock_type stock_name   list_time  wrt_valid wrt_type  wrt_code  future_valid  future_main_contract  future_last_trade_time
0     HK.24719      1000    WARRANT    腾讯东亚九四沽A  2018-07-20       True      PUT  HK.00700         False                   NaN                     NaN
..         ...       ...        ...                ...       ...        ...       ...       ...           ...                   ...                    ...
1617  HK.63402     10000    WARRANT    腾讯高盛一八牛Y  2020-11-26       True     BULL  HK.00700         False                   NaN                     NaN

[1618 rows x 11 columns]
HK.24719
['HK.24719', 'HK.27886', 'HK.28621', 'HK.14339', 'HK.27952', 'HK.18693', 'HK.20306', 'HK.53635', 'HK.47269', 'HK.27227', 
...        ...       ...        ...        ...         ...        ...      ...       ... 
'HK.63402']
******************************************
        code  lot_size stock_type         stock_name list_time  wrt_valid  wrt_type  wrt_code  future_valid  future_main_contract future_last_trade_time
0  HK.A50main      5000     FUTURE      安硕富时 A50 ETF主连(2012)                False       NaN       NaN          True                  True                       
..         ...       ...        ...                ...       ...        ...       ...       ...           ...                   ...                    ...
5  HK.A502106      5000     FUTURE      安硕富时 A50 ETF2106                False       NaN       NaN          True                 False             2021-06-29

[6 rows x 11 columns]
HK.A50main
['HK.A50main', 'HK.A502011', 'HK.A502012', 'HK.A502101', 'HK.A502103', 'HK.A502106']
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

接口限制

  • 每 30 秒内最多请求 10 次获取证券关联数据接口
  • 当获取正股相关窝轮时,不受上述限频限制