# 获取机构列表

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 次请求
  • 分页请求仅首页计入限频统计