# 獲取窩輪和期貨列表

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 次獲取證券關聯數據介面
  • 當獲取正股相關窩輪時,不受上述限頻限制