獲取 IPO 資訊

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

get_ipo_list(market)

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

  參數	類型	説明
  market	Market	市場標識 注意：這裡不區分滬和深，輸入滬或者深都會返回滬深市場的股票

• 返回

  參數	類型	説明
  ret	RET_CODE	介面呼叫結果
  data	pd.DataFrame	當 ret == RET_OK，返回 IPO 數據
  	str	當 ret != RET_OK，返回錯誤描述

  • IPO 數據

    欄位	類型	説明
    code	str	股票代碼
    name	str	股票名稱
    list_time	str	上市日期，美股是預計上市日期 格式：yyyy-MM-dd
    list_timestamp	float	上市日期時間戳記，美股是預計上市日期時間戳記
    apply_code	str	申購代碼（A 股適用）
    issue_size	int	發行總數（A 股適用）；發行量（美股適用）
    online_issue_size	int	網上發行量（A 股適用）
    apply_upper_limit	int	申購上限（A 股適用）
    apply_limit_market_value	int	頂格申購需配市值（A 股適用）
    is_estimate_ipo_price	bool	是否預估發行價（A 股適用）
    ipo_price	float	發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新 （A 股適用）
    industry_pe_rate	float	行業市盈率（A 股適用）
    is_estimate_winning_ratio	bool	是否預估中籤率（A 股適用）
    winning_ratio	float	中籤率 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20% （A 股適用）
    issue_pe_rate	float	發行市盈率（A 股適用）
    apply_time	str	申購日期字串 格式：yyyy-MM-dd （A 股適用）
    apply_timestamp	float	申購日期時間戳記（A 股適用）
    winning_time	str	公佈中籤日期字串 格式：yyyy-MM-dd （A 股適用）
    winning_timestamp	float	公佈中籤日期時間戳記（A 股適用）
    is_has_won	bool	是否已經公佈中籤號（A 股適用）
    winning_num_data	str	中籤號（A 股適用） 格式類似： 末"五"位數：12345，12346 末"六"位數：123456
    ipo_price_min	float	最低發售價（港股適用）；最低發行價（美股適用）
    ipo_price_max	float	最高發售價（港股適用）；最高發行價（美股適用）
    list_price	float	上市價（港股適用）
    lot_size	int	每手股數
    entrance_price	float	入場費（港股適用）
    is_subscribe_status	bool	是否為認購狀態 True：認購中 False：待上市
    apply_end_time	str	截止認購日期字串 格式：yyyy-MM-dd （港股適用）
    apply_end_timestamp	float	截止認購日期時間戳記

• Example

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

ret, data = quote_ctx.get_ipo_list(Market.HK)
if ret == RET_OK:
    print(data)
    print(data['code'][0])    # 取第一條的股票代碼
    print(data['code'].values.tolist())   # 轉為 list
else:
    print('error:', data)
quote_ctx.close() # 結束後記得關閉當條連線，防止連線條數用盡

• Output

    code      name   list_time  list_timestamp apply_code issue_size online_issue_size apply_upper_limit apply_limit_market_value is_estimate_ipo_price ipo_price industry_pe_rate is_estimate_winning_ratio winning_ratio issue_pe_rate apply_time apply_timestamp winning_time winning_timestamp is_has_won winning_num_data  ipo_price_min  ipo_price_max  list_price  lot_size  entrance_price  is_subscribe_status apply_end_time  apply_end_timestamp
0  HK.06666  恒大物業  2020-12-02    1.606838e+09        N/A        N/A               N/A               N/A                      N/A                   N/A       N/A              N/A                       N/A           N/A           N/A        N/A             N/A          N/A               N/A        N/A              N/A          8.500           9.75         0.0       500         4924.12                 True     2020-11-26         1.606352e+09
1  HK.02110  裕勤控股  2020-12-07    1.607270e+09        N/A        N/A               N/A               N/A                      N/A                   N/A       N/A              N/A                       N/A           N/A           N/A        N/A             N/A          N/A               N/A        N/A              N/A          0.225           0.27         0.0     10000         2727.21                 True     2020-11-27         1.606439e+09
HK.06666
['HK.06666', 'HK.02110']

Qot_GetIpoList.proto

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• 協議 ID

  3217

uint GetIpoList(QotGetIpoList.Request req);
virtual void OnReply_GetIpoList(FTAPI_Conn client, uint nSerialNo, QotGetIpoList.Response rsp);

• 介紹

獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 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;

        QotGetIpoList.C2S c2s = QotGetIpoList.C2S.CreateBuilder()
                .SetMarket((int)QotCommon.QotMarket.QotMarket_CNSH_Security)
                .Build();
        QotGetIpoList.Request req = QotGetIpoList.Request.CreateBuilder().SetC2S(c2s).Build();
        uint seqNo = qot.GetIpoList(req);
        Console.Write("Send QotGetIpoList: {0}\n", seqNo);
    }

    
    public void OnDisconnect(FTAPI_Conn client, long errCode) {
        Console.Write("Qot onDisConnect: {0}\n", errCode);
    }

    public void OnReply_GetIpoList(FTAPI_Conn client, uint nSerialNo, QotGetIpoList.Response rsp)
    {
        Console.Write("Reply: QotGetIpoList: {0}\n", nSerialNo);
        if(rsp.S2C.IpoListCount > 0)
        {
            Console.Write("name: {0} \n", rsp.S2C.IpoListList[0].Basic.Name);
        }            
    }

    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=6826061149989914129
Send QotGetIpoList: 3
Reply: QotGetIpoList: 3
name: 久祺股份

int getIpoList(QotGetIpoList.Request req);
void onReply_GetIpoList(FTAPI_Conn client, int nSerialNo, QotGetIpoList.Response rsp);

• 介紹

獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 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;

        QotGetIpoList.C2S c2s = QotGetIpoList.C2S.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .build();
        QotGetIpoList.Request req = QotGetIpoList.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.getIpoList(req);
        System.out.printf("Send QotGetIpoList: %d\n", seqNo);
    }

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

    @Override
    public void onReply_GetIpoList(FTAPI_Conn client, int nSerialNo, QotGetIpoList.Response rsp) {
        if (rsp.getRetType() != 0) {
            System.out.printf("QotGetIpoList failed: %s\n", rsp.getRetMsg());
        }
        else {
            try {
                String json = JsonFormat.printer().print(rsp);
                System.out.printf("Receive QotGetIpoList: %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 QotGetIpoList: 2
Receive QotGetIpoList: {
  "retType": 0,
  "retMsg": "",
  "errCode": 0,
  "s2c": {
    "ipoList": [{
      "basic": {
        "security": {
          "market": 1,
          "code": "02219"
        },
        "name": "朝聚眼科",
        "listTime": "2021-07-07",
        "listTimestamp": 1.6255872E9
      },
      "hkExData": {
        "ipoPriceMin": 9.48,
        "ipoPriceMax": 10.6,
        "listPrice": 0.0,
        "lotSize": 500,
        "entrancePrice": 5353.41,
        "isSubscribeStatus": true,
        "applyEndTime": "2021-06-29",
        "applyEndTimestamp": 1.6249284E9
      }
    }, ... {
      "basic": {
        "security": {
          "market": 1,
          "code": "00606"
        },
        "name": "中駿商管",
        "listTime": "2021-07-02",
        "listTimestamp": 1.6251552E9
      },
      "hkExData": {
        "ipoPriceMin": 3.7,
        "ipoPriceMax": 4.6,
        "listPrice": 0.0,
        "lotSize": 1000,
        "entrancePrice": 4646.35,
        "isSubscribeStatus": false,
        "applyEndTime": "2021-06-24",
        "applyEndTimestamp": 1.6244964E9
      }
    }]
  }
}

Futu::u32_t GetIpoList(const Qot_GetIpoList::Request &stReq);
virtual void OnReply_GetIpoList(Futu::u32_t nSerialNo, const Qot_GetIpoList::Response &stRsp) = 0;

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

class Program : public FTSPI_Qot, public FTSPI_Trd, public FTSPI_Conn
{
public:

	Program() {
		m_pQotApi = FTAPI::CreateQotApi();
		m_pQotApi->RegisterQotSpi(this);
		m_pQotApi->RegisterConnSpi(this);
	}

	~Program() {
		if (m_pQotApi != nullptr)
		{
			m_pQotApi->UnregisterQotSpi();
			m_pQotApi->UnregisterConnSpi();
			FTAPI::ReleaseQotApi(m_pQotApi);
			m_pQotApi = nullptr;
		}
	}

	void Start() {
		m_pQotApi->InitConnect("127.0.0.1", 11111, false);
	}


	virtual void OnInitConnect(FTAPI_Conn* pConn, Futu::i64_t nErrCode, const char* strDesc) {
		cout << "connect" << endl;

		// 組包
		Qot_GetIpoList::Request req;
		Qot_GetIpoList::C2S *c2s = req.mutable_c2s();
		c2s->set_market(1);

        m_GetIpoListSerialNo = m_pQotApi->GetIpoList(req);
        cout << "Request GetIpoList SerialNo: " << m_GetIpoListSerialNo << endl;
	}

	virtual void OnReply_GetIpoList(Futu::u32_t nSerialNo, const Qot_GetIpoList::Response &stRsp){
        if(nSerialNo == m_GetIpoListSerialNo)
        {
            cout << "OnReply_GetIpoList SerialNo: " << nSerialNo << endl;
            // 解析內部結構列印出來
            // ProtoBufToBodyData和UTF8ToLocal函數的定義參見Sample中的tool.h檔案
            string resp_str;
            ProtoBufToBodyData(stRsp, resp_str);
            cout << UTF8ToLocal(resp_str) << endl;
        }
	}

protected:
	FTAPI_Qot *m_pQotApi;

    Futu::u32_t m_GetIpoListSerialNo;
};

int32_t main(int32_t argc, char** argv)
{
	FTAPI::Init();

	{
		Program program;
		program.Start();
		getchar();
	}

	protobuf::ShutdownProtobufLibrary();
	FTAPI::UnInit();
	return 0;
}

• Output

connect
Request GetIpoList SerialNo: 4
OnReply_GetIpoList SerialNo: 4
{
 "retType": 0,
 "retMsg": "",
 "errCode": 0,
 "s2c": {
  "ipoList": [
   {
    "basic": {
     "security": {
      "market": 1,
      "code": "06699"
     },
     "name": "時代天使",
     "listTime": "2021-06-16",
     "listTimestamp": 1623772800
    },
    "hkExData": {
     "ipoPriceMin": 147,
     "ipoPriceMax": 173,
     "listPrice": 0,
     "lotSize": 200,
     "entrancePrice": 34948.66,
     "isSubscribeStatus": false,
     "applyEndTime": "2021-06-08",
     "applyEndTimestamp": 1623119400
    }
   },
...
   {
    "basic": {
     "security": {
      "market": 1,
      "code": "04246"
     },
     "name": "政府債券二四零六",
     "listTime": "2021-06-24",
     "listTimestamp": 1624464000
    },
    "hkExData": {
     "ipoPriceMin": 100,
     "ipoPriceMax": 100,
     "listPrice": 0,
     "lotSize": 100,
     "entrancePrice": 10000,
     "isSubscribeStatus": true,
     "applyEndTime": "2021-06-11",
     "applyEndTimestamp": 1623378600
    }
   }
  ]
 }
}

GetIpoList(req);

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

import ftWebsocket from "futu-api";
import { ftCmdID } from "futu-api";
import { Common, Qot_Common } from "futu-api/proto";
import beautify from "js-beautify";

function QotGetIpoList(){
	const { RetType } = Common
	const { QotMarket } = Qot_Common
	let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
	let websocket = new ftWebsocket();

	websocket.onlogin = (ret, msg)=>{
		if (ret) { // 登入成功

			const req = {
				c2s: {
					market: QotMarket.QotMarket_US_Security,
				},
			};

			websocket.GetIpoList(req)
			.then((res) => {
				let { errCode, retMsg, retType,s2c } = res
				console.log("IpoList: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType); 
				if(retType == RetType.RetType_Succeed){
					let data = beautify(JSON.stringify(s2c), {
						indent_size: 2,
						space_in_empty_paren: true,
					});
					console.log(data);
				}
			})
			.catch((error) => {
				console.log("error:", error);
			});
		} else {
			console.log("error", msg);
		}
	};

	websocket.start(addr, port, enable_ssl, key);
	
	//關閉行情連線，連線不再使用之後，要關閉，否則佔用不必要資源
	//同時OpenD也限制了最多128條連線
	//也可以一個頁面或者一個專案維護一條連線，這裡範例請求一次建立一條連線
	setTimeout(()=>{ 
		websocket.stop();
		console.log("stop");
	}, 5000); // 5秒後斷開
}

• Output

IpoList: errCode 0, retMsg , retType 0
{
  "ipoList": [{
    "basic": {
      "security": {
        "market": 11,
        "code": "FHLTU"
      },
      "name": "Future Health ESG Corp.",
      "listTime": "2021-09-10",
      "listTimestamp": 1631246400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "20000000"
    }
  }, {
    "basic": {
      "security": {
        "market": 11,
        "code": "FLAG.U"
      },
      "name": "FIRST LIGHT ACQUISITION GROUP, INC.",
      "listTime": "2021-09-10",
      "listTimestamp": 1631246400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "20000000"
    }
  }, ..., {
    "basic": {
      "security": {
        "market": 11,
        "code": "ROXA"
      },
      "name": "ROX FINANCIAL LP",
      "listTime": "2021-09-30",
      "listTimestamp": 1632974400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "8300000"
    }
  }]
}
stop

介面限制

• 每 30 秒內最多請求 10 次獲取 IPO 資訊介面

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

get_ipo_list(market)

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

  參數	類型	説明
  market	Market	市場標識 注意：這裡不區分滬和深，輸入滬或者深都會返回滬深市場的股票

• 返回

  參數	類型	説明
  ret	RET_CODE	介面呼叫結果
  data	pd.DataFrame	當 ret == RET_OK，返回 IPO 數據
  	str	當 ret != RET_OK，返回錯誤描述

  • IPO 數據

    欄位	類型	説明
    code	str	股票代碼
    name	str	股票名稱
    list_time	str	上市日期，美股是預計上市日期 格式：yyyy-MM-dd
    list_timestamp	float	上市日期時間戳記，美股是預計上市日期時間戳記
    apply_code	str	申購代碼（A 股適用）
    issue_size	int	發行總數（A 股適用）；發行量（美股適用）
    online_issue_size	int	網上發行量（A 股適用）
    apply_upper_limit	int	申購上限（A 股適用）
    apply_limit_market_value	int	頂格申購需配市值（A 股適用）
    is_estimate_ipo_price	bool	是否預估發行價（A 股適用）
    ipo_price	float	發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新 （A 股適用）
    industry_pe_rate	float	行業市盈率（A 股適用）
    is_estimate_winning_ratio	bool	是否預估中籤率（A 股適用）
    winning_ratio	float	中籤率 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20% （A 股適用）
    issue_pe_rate	float	發行市盈率（A 股適用）
    apply_time	str	申購日期字串 格式：yyyy-MM-dd （A 股適用）
    apply_timestamp	float	申購日期時間戳記（A 股適用）
    winning_time	str	公佈中籤日期字串 格式：yyyy-MM-dd （A 股適用）
    winning_timestamp	float	公佈中籤日期時間戳記（A 股適用）
    is_has_won	bool	是否已經公佈中籤號（A 股適用）
    winning_num_data	str	中籤號（A 股適用） 格式類似： 末"五"位數：12345，12346 末"六"位數：123456
    ipo_price_min	float	最低發售價（港股適用）；最低發行價（美股適用）
    ipo_price_max	float	最高發售價（港股適用）；最高發行價（美股適用）
    list_price	float	上市價（港股適用）
    lot_size	int	每手股數
    entrance_price	float	入場費（港股適用）
    is_subscribe_status	bool	是否為認購狀態 True：認購中 False：待上市
    apply_end_time	str	截止認購日期字串 格式：yyyy-MM-dd （港股適用）
    apply_end_timestamp	float	截止認購日期時間戳記

• Example

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

ret, data = quote_ctx.get_ipo_list(Market.HK)
if ret == RET_OK:
    print(data)
    print(data['code'][0])    # 取第一條的股票代碼
    print(data['code'].values.tolist())   # 轉為 list
else:
    print('error:', data)
quote_ctx.close() # 結束後記得關閉當條連線，防止連線條數用盡

• Output

    code      name   list_time  list_timestamp apply_code issue_size online_issue_size apply_upper_limit apply_limit_market_value is_estimate_ipo_price ipo_price industry_pe_rate is_estimate_winning_ratio winning_ratio issue_pe_rate apply_time apply_timestamp winning_time winning_timestamp is_has_won winning_num_data  ipo_price_min  ipo_price_max  list_price  lot_size  entrance_price  is_subscribe_status apply_end_time  apply_end_timestamp
0  HK.06666  恒大物業  2020-12-02    1.606838e+09        N/A        N/A               N/A               N/A                      N/A                   N/A       N/A              N/A                       N/A           N/A           N/A        N/A             N/A          N/A               N/A        N/A              N/A          8.500           9.75         0.0       500         4924.12                 True     2020-11-26         1.606352e+09
1  HK.02110  裕勤控股  2020-12-07    1.607270e+09        N/A        N/A               N/A               N/A                      N/A                   N/A       N/A              N/A                       N/A           N/A           N/A        N/A             N/A          N/A               N/A        N/A              N/A          0.225           0.27         0.0     10000         2727.21                 True     2020-11-27         1.606439e+09
HK.06666
['HK.06666', 'HK.02110']

Qot_GetIpoList.proto

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• 協議 ID

  3217

uint GetIpoList(QotGetIpoList.Request req);
virtual void OnReply_GetIpoList(MMAPI_Conn client, uint nSerialNo, QotGetIpoList.Response rsp);

• 介紹

獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

public class Program : MMSPI_Qot, MMSPI_Conn {
    MMAPI_Qot qot = new MMAPI_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(MMAPI_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;

        QotGetIpoList.C2S c2s = QotGetIpoList.C2S.CreateBuilder()
                .SetMarket((int)QotCommon.QotMarket.QotMarket_CNSH_Security)
                .Build();
        QotGetIpoList.Request req = QotGetIpoList.Request.CreateBuilder().SetC2S(c2s).Build();
        uint seqNo = qot.GetIpoList(req);
        Console.Write("Send QotGetIpoList: {0}\n", seqNo);
    }

    
    public void OnDisconnect(MMAPI_Conn client, long errCode) {
        Console.Write("Qot onDisConnect: {0}\n", errCode);
    }

    public void OnReply_GetIpoList(MMAPI_Conn client, uint nSerialNo, QotGetIpoList.Response rsp)
    {
        Console.Write("Reply: QotGetIpoList: {0}\n", nSerialNo);
        if(rsp.S2C.IpoListCount > 0)
        {
            Console.Write("name: {0} \n", rsp.S2C.IpoListList[0].Basic.Name);
        }            
    }

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

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

• Output

Qot onInitConnect: ret=0 desc= connID=6826061149989914129
Send QotGetIpoList: 3
Reply: QotGetIpoList: 3
name: 久祺股份

int getIpoList(QotGetIpoList.Request req);
void onReply_GetIpoList(MMAPI_Conn client, int nSerialNo, QotGetIpoList.Response rsp);

• 介紹

獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

public class QotDemo implements MMSPI_Qot, MMSPI_Conn {
    MMAPI_Conn_Qot qot = new MMAPI_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(MMAPI_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;

        QotGetIpoList.C2S c2s = QotGetIpoList.C2S.newBuilder()
                .setMarket(QotCommon.QotMarket.QotMarket_HK_Security_VALUE)
                .build();
        QotGetIpoList.Request req = QotGetIpoList.Request.newBuilder().setC2S(c2s).build();
        int seqNo = qot.getIpoList(req);
        System.out.printf("Send QotGetIpoList: %d\n", seqNo);
    }

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

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

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

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

            }
        }
    }
}

• Output

Send QotGetIpoList: 2
Receive QotGetIpoList: {
  "retType": 0,
  "retMsg": "",
  "errCode": 0,
  "s2c": {
    "ipoList": [{
      "basic": {
        "security": {
          "market": 1,
          "code": "02219"
        },
        "name": "朝聚眼科",
        "listTime": "2021-07-07",
        "listTimestamp": 1.6255872E9
      },
      "hkExData": {
        "ipoPriceMin": 9.48,
        "ipoPriceMax": 10.6,
        "listPrice": 0.0,
        "lotSize": 500,
        "entrancePrice": 5353.41,
        "isSubscribeStatus": true,
        "applyEndTime": "2021-06-29",
        "applyEndTimestamp": 1.6249284E9
      }
    }, ... {
      "basic": {
        "security": {
          "market": 1,
          "code": "00606"
        },
        "name": "中駿商管",
        "listTime": "2021-07-02",
        "listTimestamp": 1.6251552E9
      },
      "hkExData": {
        "ipoPriceMin": 3.7,
        "ipoPriceMax": 4.6,
        "listPrice": 0.0,
        "lotSize": 1000,
        "entrancePrice": 4646.35,
        "isSubscribeStatus": false,
        "applyEndTime": "2021-06-24",
        "applyEndTimestamp": 1.6244964E9
      }
    }]
  }
}

moomoo::u32_t GetIpoList(const Qot_GetIpoList::Request &stReq);
virtual void OnReply_GetIpoList(moomoo::u32_t nSerialNo, const Qot_GetIpoList::Response &stRsp) = 0;

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

class Program : public MMSPI_Qot, public MMSPI_Trd, public MMSPI_Conn
{
public:

	Program() {
		m_pQotApi = MMAPI::CreateQotApi();
		m_pQotApi->RegisterQotSpi(this);
		m_pQotApi->RegisterConnSpi(this);
	}

	~Program() {
		if (m_pQotApi != nullptr)
		{
			m_pQotApi->UnregisterQotSpi();
			m_pQotApi->UnregisterConnSpi();
			MMAPI::ReleaseQotApi(m_pQotApi);
			m_pQotApi = nullptr;
		}
	}

	void Start() {
		m_pQotApi->InitConnect("127.0.0.1", 11111, false);
	}


	virtual void OnInitConnect(MMAPI_Conn* pConn, moomoo::i64_t nErrCode, const char* strDesc) {
		cout << "connect" << endl;

		// 組包
		Qot_GetIpoList::Request req;
		Qot_GetIpoList::C2S *c2s = req.mutable_c2s();
		c2s->set_market(1);

        m_GetIpoListSerialNo = m_pQotApi->GetIpoList(req);
        cout << "Request GetIpoList SerialNo: " << m_GetIpoListSerialNo << endl;
	}

	virtual void OnReply_GetIpoList(moomoo::u32_t nSerialNo, const Qot_GetIpoList::Response &stRsp){
        if(nSerialNo == m_GetIpoListSerialNo)
        {
            cout << "OnReply_GetIpoList SerialNo: " << nSerialNo << endl;
            // 解析內部結構列印出來
            // ProtoBufToBodyData和UTF8ToLocal函數的定義參見Sample中的tool.h檔案
            string resp_str;
            ProtoBufToBodyData(stRsp, resp_str);
            cout << UTF8ToLocal(resp_str) << endl;
        }
	}

protected:
	MMAPI_Qot *m_pQotApi;

    moomoo::u32_t m_GetIpoListSerialNo;
};

int32_t main(int32_t argc, char** argv)
{
	MMAPI::Init();

	{
		Program program;
		program.Start();
		getchar();
	}

	protobuf::ShutdownProtobufLibrary();
	MMAPI::UnInit();
	return 0;
}

• Output

connect
Request GetIpoList SerialNo: 4
OnReply_GetIpoList SerialNo: 4
{
 "retType": 0,
 "retMsg": "",
 "errCode": 0,
 "s2c": {
  "ipoList": [
   {
    "basic": {
     "security": {
      "market": 1,
      "code": "06699"
     },
     "name": "時代天使",
     "listTime": "2021-06-16",
     "listTimestamp": 1623772800
    },
    "hkExData": {
     "ipoPriceMin": 147,
     "ipoPriceMax": 173,
     "listPrice": 0,
     "lotSize": 200,
     "entrancePrice": 34948.66,
     "isSubscribeStatus": false,
     "applyEndTime": "2021-06-08",
     "applyEndTimestamp": 1623119400
    }
   },
...
   {
    "basic": {
     "security": {
      "market": 1,
      "code": "04246"
     },
     "name": "政府債券二四零六",
     "listTime": "2021-06-24",
     "listTimestamp": 1624464000
    },
    "hkExData": {
     "ipoPriceMin": 100,
     "ipoPriceMax": 100,
     "listPrice": 0,
     "lotSize": 100,
     "entrancePrice": 10000,
     "isSubscribeStatus": true,
     "applyEndTime": "2021-06-11",
     "applyEndTimestamp": 1623378600
    }
   }
  ]
 }
}

GetIpoList(req);

• 介紹

  獲取指定市場的 IPO 資訊

• 參數

message C2S
{
	required int32 market = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
}

message Request
{
	required C2S c2s = 1;
}

• 行情市場參見 QotMarket

• 返回

// IPO 基本數據
message BasicIpoData
{
	required Qot_Common.Security security = 1; // Qot_Common::QotMarket 股票市場，支援滬股和深股，且滬股和深股不做區分都代表 A 股市場。
	required string name = 2; // 股票名稱
	optional string listTime = 3; // 上市日期字串（格式：yyyy-MM-dd）
	optional double listTimestamp = 4; // 上市日期時間戳記
};

// A 股 IPO 列表額外數據
message CNIpoExData 
{
	required string applyCode = 1; // 申購代碼
	required int64 issueSize = 2; // 發行總數
	required int64 onlineIssueSize = 3; // 網上發行量
	required int64 applyUpperLimit = 4; // 申購上限
	required int64 applyLimitMarketValue = 5; // 頂格申購需配市值
	required bool isEstimateIpoPrice = 6; // 是否預估發行價
	required double ipoPrice = 7; // 發行價 預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double industryPeRate = 8; // 行業市盈率
	required bool isEstimateWinningRatio = 9; // 是否預估中籤率
	required double winningRatio = 10; // 中籤率 該欄位為百分比欄位，預設不展示 %，如 20 實際對應 20%。預估值會因為募集資金、發行數量、發行費用等數據變動而變動，僅供參考。實際數據公佈後會第一時間更新。
	required double issuePeRate = 11; // 發行市盈率
	optional string applyTime = 12; // 申購日期字串（格式：yyyy-MM-dd）
	optional double applyTimestamp = 13; // 申購日期時間戳記
	optional string winningTime = 14; // 公佈中籤日期字串（格式：yyyy-MM-dd）
	optional double winningTimestamp = 15; // 公佈中籤日期時間戳記
	required bool isHasWon = 16; // 是否已經公佈中籤號
	repeated WinningNumData winningNumData = 17; // Qot_GetIpoList::WinningNumData 中籤號數據，對應 PC 中"公佈中籤日期的已公佈"
};

// 中籤號數據
message WinningNumData
{
	required string winningName = 1; // 分組名
    required string winningInfo = 2; // 中籤號資訊
}

// 港股 IPO 列表額外數據
message HKIpoExData
{
	required double ipoPriceMin = 1; // 最低發售價
	required double ipoPriceMax = 2; // 最高發售價
	required double listPrice = 3; // 上市價
	required int32 lotSize = 4; // 每手股數
	required double entrancePrice = 5; // 入場費
	required bool isSubscribeStatus = 6; // 是否為認購狀態，True-認購中，False-待上市
	optional string applyEndTime = 7; // 截止認購日期字串（格式：yyyy-MM-dd）
	optional double applyEndTimestamp = 8; // 截止認購日期時間戳記 因需處理認購手續，富途認購截止時間會早於交易所公佈的日期。
};

// 美股 IPO 列表額外數據
message USIpoExData  
{
	required double ipoPriceMin = 1; // 最低發行價
	required double ipoPriceMax = 2; // 最高發行價
	required int64 issueSize = 3; // 發行量
};

// 新股 IPO 數據
message IpoData
{	
	required BasicIpoData basic = 1; // IPO 基本數據	
	optional CNIpoExData cnExData = 2; // A 股 IPO 額外數據
	optional HKIpoExData hkExData = 3; // 港股 IPO 額外數據
	optional USIpoExData usExData = 4; // 美股 IPO 額外數據
};

message S2C
{
	repeated IpoData ipoList = 1; // 新股 IPO 數據
}

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

• 股票結構參見 Security
• 介面呼叫結果，結構參見 RetType

• Example

import mmWebsocket from "moomoo-api";
import { mmCmdID } from "moomoo-api";
import { Common, Qot_Common } from "moomoo-api/proto";
import beautify from "js-beautify";

function QotGetIpoList(){
	const { RetType } = Common
	const { QotMarket } = Qot_Common
	let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
	let websocket = new mmWebsocket();

	websocket.onlogin = (ret, msg)=>{
		if (ret) { // 登入成功

			const req = {
				c2s: {
					market: QotMarket.QotMarket_US_Security,
				},
			};

			websocket.GetIpoList(req)
			.then((res) => {
				let { errCode, retMsg, retType,s2c } = res
				console.log("IpoList: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType); 
				if(retType == RetType.RetType_Succeed){
					let data = beautify(JSON.stringify(s2c), {
						indent_size: 2,
						space_in_empty_paren: true,
					});
					console.log(data);
				}
			})
			.catch((error) => {
				console.log("error:", error);
			});
		} else {
			console.log("error", msg);
		}
	};

	websocket.start(addr, port, enable_ssl, key);
	
	//關閉行情連線，連線不再使用之後，要關閉，否則佔用不必要資源
	//同時OpenD也限制了最多128條連線
	//也可以一個頁面或者一個專案維護一條連線，這裡範例請求一次建立一條連線
	setTimeout(()=>{ 
		websocket.stop();
		console.log("stop");
	}, 5000); // 5秒後斷開
}

• Output

IpoList: errCode 0, retMsg , retType 0
{
  "ipoList": [{
    "basic": {
      "security": {
        "market": 11,
        "code": "FHLTU"
      },
      "name": "Future Health ESG Corp.",
      "listTime": "2021-09-10",
      "listTimestamp": 1631246400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "20000000"
    }
  }, {
    "basic": {
      "security": {
        "market": 11,
        "code": "FLAG.U"
      },
      "name": "FIRST LIGHT ACQUISITION GROUP, INC.",
      "listTime": "2021-09-10",
      "listTimestamp": 1631246400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "20000000"
    }
  }, ..., {
    "basic": {
      "security": {
        "market": 11,
        "code": "ROXA"
      },
      "name": "ROX FINANCIAL LP",
      "listTime": "2021-09-30",
      "listTimestamp": 1632974400
    },
    "usExData": {
      "ipoPriceMin": 10,
      "ipoPriceMax": 10,
      "issueSize": "8300000"
    }
  }]
}
stop

介面限制

• 每 30 秒內最多請求 10 次獲取 IPO 資訊介面