获取大股东持股变动（已废弃）

• Python
• Proto
• C#
• Java
• C++
• JavaScript

get_holding_change_list

get_holding_change_list(code, holder_type, start=None, end=None)

• 介绍

  获取大股东持股变动列表

• 参数

  参数	类型	说明
  code	str	股票代码
  holder_type	StockHolder	持有者类别
  start	str	开始时间 例如：“2016-10-01”
  end	str	结束时间 例如：“2017-10-01”

  • start 和 end 组合如下:

    Start 类型	End 类型	说明
    str	str	start 和 end 分别为指定的日期
    None	str	start 为 end 往前 365 天
    str	None	end 为 start 往后 365 天
    None	None	end 为当前日期，start 为 end 往前 365 天

• 返回

  参数	类型	说明
  ret	RET_CODE	接口调用结果
  data	pd.DataFrame	当 ret == RET_OK，返回持股变动数据
  	str	当 ret != RET_OK，返回错误描述

  • 持股变动数据

    字段	类型	说明
    holder_name	str	高管名称
    holding_qty	float	持股数
    holding_ratio	float	持股比例 该字段为百分比字段，默认不展示 %，如 20 实际对应 20%
    change_qty	float	变动数
    change_ratio	float	变动比例 相对于自身的比例 该字段为百分比字段，默认不展示 %，如 20 实际对应 20% 举例：总股本 1 万股，持有 100 股，持股百分比是 1%，卖掉 50 股，变动比例是 50 %，而不是 0.5%
    time	str	发布时间 美股的时间默认是美东

• Example

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

ret, data = quote_ctx.get_holding_change_list('US.AAPL', StockHolder.INSTITUTE, '2018-10-01')
if ret == RET_OK:
    print(data)
    print(data['holding_ratio'][0])   # 取第一条的持股比例
    print(data['holding_ratio'].values.tolist())   # 转为 list
else:
    print('error:', data)
quote_ctx.close() # 结束后记得关闭当条连接，防止连接条数用尽

• Output

    holder_name  holding_qty  holding_ratio  change_qty  change_ratio                 time
0   The Vanguard Group, Inc.  331132509.0         7.4525  -3981157.0         -1.19  2019-09-30 00:00:00
..                                                ...          ...            ...         ...           ...                  ...
92  Los Angeles Capital Management And Equity Rese...    4007663.0         0.0902    -57784.0         -1.42  2019-09-30 00:00:00

[93 rows x 6 columns]
7.4525
[7.4525, 5.6004, 4.3059, 4.1463, 2.1087, 1.3884, 1.0522, 0.905, 0.7931, 0.7871, 0.7782, 0.6872, 0.6687, 0.666, 0.6186, 0.0956, 0.0954, 0.0903, 
..                                                ...          ...            ...         ...           ...                  ...
0.0903, 0.0902]

Qot_GetHoldingChangeList.proto

• 介绍

  获取大股东持股变动列表

• 参数

message C2S
{
	required Qot_Common.Security security = 1; //股票
	required int32 holderCategory = 2; //持有者类别（1机构、2基金、3高管）
	//以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据
	optional string beginTime = 3; //开始时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
	optional string endTime = 4; //结束时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
}

message Request
{
	required C2S c2s = 1;
}

• 股票结构参见 Security
• 持有者类别枚举参见 HolderCategory

• 返回

message S2C
{
    required Qot_Common.Security security = 1; //股票
	repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化）
}

message Response
{
	required int32 retType = 1 [default = -400]; //RetType,返回结果
	optional string retMsg = 2;
	optional int32 errCode = 3;
	optional S2C s2c = 4;
}

• 股票结构参见 Security
• 持股变化列表结构参见 ShareHoldingChange
• 接口调用结果，结构参见 RetType

• 协议 ID

  3208

GetHoldingChangeList

uint GetHoldingChangeList(QotGetHoldingChangeList.Request req);
virtual void OnReply_GetHoldingChangeList(FTAPI_Conn client, uint nSerialNo, QotGetHoldingChangeList.Response rsp);

• 介绍

获取大股东持股变动列表

• 参数

message C2S
{
	required Qot_Common.Security security = 1; //股票
	required int32 holderCategory = 2; //持有者类别（1机构、2基金、3高管）
	//以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据
	optional string beginTime = 3; //开始时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
	optional string endTime = 4; //结束时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
}

message Request
{
	required C2S c2s = 1;
}

• 股票结构参见 Security
• 持有者类别枚举参见 HolderCategory

• 返回

message S2C
{
    required Qot_Common.Security security = 1; //股票
	repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化）
}

message Response
{
	required int32 retType = 1 [default = -400]; //RetType,返回结果
	optional string retMsg = 2;
	optional int32 errCode = 3;
	optional S2C s2c = 4;
}

• 股票结构参见 Security
• 持股变化列表结构参见 ShareHoldingChange
• 接口调用结果，结构参见 RetType

• Example

public class Program : FTSPI_Qot, FTSPI_Conn {
    FTAPI_Qot qot = new FTAPI_Qot();

    public Program() {
        qot.SetClientInfo("csharp", 1);  //设置客户端信息
        qot.SetConnCallback(this);  //设置连接回调
        qot.SetQotCallback(this);   //设置交易回调
    }

    public void Start() {
        qot.InitConnect("127.0.0.1", (ushort)11111, false);
    }

    
    public void OnInitConnect(FTAPI_Conn client, long errCode, String desc)
    {
        Console.Write("Qot onInitConnect: ret={0} desc={1} connID={2}\n", errCode, desc, client.GetConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security sec = QotCommon.Security.CreateBuilder()
                .SetMarket((int)QotCommon.QotMarket.QotMarket_HK_Security)
                .SetCode("00700")
                .Build();
        QotGetHoldingChangeList.C2S c2s = QotGetHoldingChangeList.C2S.CreateBuilder()
                .SetSecurity(sec)
                .SetHolderCategory((int)QotCommon.HolderCategory.HolderCategory_Agency)
            .Build();
        QotGetHoldingChangeList.Request req = QotGetHoldingChangeList.Request.CreateBuilder().SetC2S(c2s).Build();
        uint seqNo = qot.GetHoldingChangeList(req);
        Console.Write("Send QotGetHoldingChangeList: {0}\n", seqNo);
    }

    
    public void OnDisconnect(FTAPI_Conn client, long errCode) {
        Console.Write("Qot onDisConnect: {0}\n", errCode);
    }
    
    public void OnReply_GetHoldingChangeList(FTAPI_Conn client, uint nSerialNo, QotGetHoldingChangeList.Response rsp)
    {
        Console.Write("Reply: QotGetHoldingChangeList: {0}\n", nSerialNo);
        Console.Write("retMsg: {0}\n", rsp.RetMsg);
    }

    public static void Main(String[] args) {
        FTAPI.Init();
        Program qot = new Program();
        qot.Start();


        while (true)
            Thread.Sleep(1000 * 600);
    }
}

• Output

Qot onInitConnect: ret=0 desc= connID=6825949628551116548
Send QotGetHoldingChangeList: 3
Reply: QotGetHoldingChangeList: 3
retMsg: 因上游数据提供商的原因，获取大股东持股变动接口（协议ID：3208）将于 2020-12-21 停止使用

getHoldingChangeList

int getHoldingChangeList(QotGetHoldingChangeList.Request req);
void onReply_GetHoldingChangeList(FTAPI_Conn client, int nSerialNo, QotGetHoldingChangeList.Response rsp);

• 介绍

获取大股东持股变动列表

• 参数

message C2S
{
	required Qot_Common.Security security = 1; //股票
	required int32 holderCategory = 2; //持有者类别（1机构、2基金、3高管）
	//以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据
	optional string beginTime = 3; //开始时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
	optional string endTime = 4; //结束时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
}

message Request
{
	required C2S c2s = 1;
}

• 股票结构参见 Security
• 持有者类别枚举参见 HolderCategory

• 返回

message S2C
{
    required Qot_Common.Security security = 1; //股票
	repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化）
}

message Response
{
	required int32 retType = 1 [default = -400]; //RetType,返回结果
	optional string retMsg = 2;
	optional int32 errCode = 3;
	optional S2C s2c = 4;
}

• 股票结构参见 Security
• 持股变化列表结构参见 ShareHoldingChange
• 接口调用结果，结构参见 RetType

• Example

public class QotDemo implements FTSPI_Qot, FTSPI_Conn {
    FTAPI_Conn_Qot qot = new FTAPI_Conn_Qot();

    public QotDemo() {
        qot.setClientInfo("javaclient", 1);  //设置客户端信息
        qot.setConnSpi(this);  //设置连接回调
        qot.setQotSpi(this);   //设置交易回调
    }

    public void start() {
        qot.initConnect("127.0.0.1", (short)11111, false);
    }

    @Override
    public void onInitConnect(FTAPI_Conn client, long errCode, String desc)
    {
        System.out.printf("Qot onInitConnect: ret=%b desc=%s connID=%d\n", errCode, desc, client.getConnectID());
        if (errCode != 0)
            return;

        QotCommon.Security sec = QotCommon.Security.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .setCode("00700")
                .build();
        QotGetHoldingChangeList.C2S c2s = QotGetHoldingChangeList.C2S.newBuilder()
                .setSecurity(sec)
                .setHolderCategory(QotCommon.HolderCategory.HolderCategory_Agency_VALUE)
            .build();
        QotGetHoldingChangeList.Request req = QotGetHoldingChangeList.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.getHoldingChangeList(req);
        System.out.printf("Send QotGetHoldingChangeList: %d\n", seqNo);
    }

    @Override
    public void onDisconnect(FTAPI_Conn client, long errCode) {
        System.out.printf("Qot onDisConnect: %d\n", errCode);
    }

    @Override
    public void onReply_GetHoldingChangeList(FTAPI_Conn client, int nSerialNo, QotGetHoldingChangeList.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotGetHoldingChangeList failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotGetHoldingChangeList: %s\n", json);
            } catch (InvalidProtocolBufferException e) {
                e.printStackTrace();
            }
        }
    }

    public static void main(String[] args) {
        FTAPI.init();
        QotDemo qot = new QotDemo();
        qot.start();

        while (true) {
            try {
                Thread.sleep(1000 * 600);
            } catch (InterruptedException exc) {

            }
        }
    }
}

• Output

Send QotGetHoldingChangeList: 2
QotGetHoldingChangeList failed: 因上游数据提供商的原因，获取大股东持股变动接口（协议ID：3208）将于 2020-12-21 停止使用

GetHoldingChangeList

Futu::u32_t GetHoldingChangeList(const Qot_GetHoldingChangeList::Request &stReq);
virtual void OnReply_GetHoldingChangeList(Futu::u32_t nSerialNo, const Qot_GetHoldingChangeList::Response &stRsp) = 0;

• 介绍

  获取大股东持股变动列表

• 参数

message C2S
{
	required Qot_Common.Security security = 1; //股票
	required int32 holderCategory = 2; //持有者类别（1机构、2基金、3高管）
	//以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据
	optional string beginTime = 3; //开始时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
	optional string endTime = 4; //结束时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
}

message Request
{
	required C2S c2s = 1;
}

• 股票结构参见 Security
• 持有者类别枚举参见 HolderCategory

• 返回

message S2C
{
    required Qot_Common.Security security = 1; //股票
	repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化）
}

message Response
{
	required int32 retType = 1 [default = -400]; //RetType,返回结果
	optional string retMsg = 2;
	optional int32 errCode = 3;
	optional S2C s2c = 4;
}

• 股票结构参见 Security
• 持股变化列表结构参见 ShareHoldingChange
• 接口调用结果，结构参见 RetType

GetHoldingChangeList

GetHoldingChangeList(req);

• 介绍

  获取大股东持股变动列表

• 参数

message C2S
{
	required Qot_Common.Security security = 1; //股票
	required int32 holderCategory = 2; //持有者类别（1机构、2基金、3高管）
	//以下是发布时间筛选，不传返回所有数据，传了返回发布时间属于开始时间到结束时间段内的数据
	optional string beginTime = 3; //开始时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
	optional string endTime = 4; //结束时间，严格按 YYYY-MM-DD HH:MM:SS 或 YYYY-MM-DD HH:MM:SS.MS 格式传
}

message Request
{
	required C2S c2s = 1;
}

• 股票结构参见 Security
• 持有者类别枚举参见 HolderCategory

• 返回

message S2C
{
    required Qot_Common.Security security = 1; //股票
	repeated Qot_Common.ShareHoldingChange holdingChangeList = 2; //对应类别的持股变化列表（最多返回前100大股东的变化）
}

message Response
{
	required int32 retType = 1 [default = -400]; //RetType,返回结果
	optional string retMsg = 2;
	optional int32 errCode = 3;
	optional S2C s2c = 4;
}

• 股票结构参见 Security
• 持股变化列表结构参见 ShareHoldingChange
• 接口调用结果，结构参见 RetType

接口限制

• 每 30 秒内最多请求 30 次获取大股东持股变动接口
• 每次最多返回前 100 位大股东的持股变动
• 获取大股东持股变动接口仅适用于美股市场