# 獲取機構列表

get_institution_list(market, sort_field=None, sort_dir=None, count=None, page=None, name_part=None)

  • 介紹

    獲取機構列表,返回指定市場中按持倉市值/增減倉/持倉股數等維度排行的機構列表,支持模糊搜索和遊標翻頁。

  • 參數

    參數 類型 說明
    market Market 市場類型(HK/US)(必填)
    sort_field InstitutionListSortField 排序字段,默認持倉市值
    sort_dir RankSortDir 排序方向,默認降序
    count int 返回數量 [1, 200],默認 20
    page str 翻頁遊標,首次不傳,續頁傳上次返回的 next_page
    name_part str 機構名模糊搜索
  • 返回

    參數 類型 說明
    ret RET_CODE 接口調用結果
    data pd.DataFrame 當 ret == RET_OK,返回數據
    str 當 ret != RET_OK,返回錯誤描述
    • 數據格式如下:
      字段 類型 說明
      institution_id int 機構 ID
      institution_name str 機構名稱
      position_value float 持倉市值
      position_value_change float 持倉市值變化
      position_count int 持倉股票數
      position_count_change int 持倉股票數變化
      disclosure_date str 披露日期(yyyy-MM-dd)
      currency str 幣種
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret, data, next_page, all_count = quote_ctx.get_institution_list(market=Market.US, count=2)
if ret == RET_OK:
    print(f'總數據量: {all_count}')
    print(data)
else:
    print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
  • Output
總數據量: 17030
   institution_id                  institution_name  position_value  position_value_change  position_count  position_count_change disclosure_date currency
0          403413                               貝萊德    6.959193e+12           3.432083e+10            4443                     56      2026-06-19      USD
1      1951572549  Vanguard Capital Management, LLC    4.881261e+12           4.492246e+12            4289                   3859      2026-06-10      USD
1
2
3
4

接口限制

  • 30 秒內最多 60 次請求
  • 分頁請求僅首頁計入限頻統計