圈券查詢

QueryReservedStocks

版本資訊

v2.2.9 起新增功能

輸入參數

參數	類別	說明
account	Account	帳號

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	List	回傳已圈存股票列表，查無資料時為空列表
message	string	當is_success = false 回傳錯誤訊息

圈券餘額 ReserveStockItem 欄位

Return type : Object

參數	類別	說明
stock_no	string	股票代號
market	Market	市場別 : TAIEX 上市 、 TAISDAQ 上櫃 、 TAIEMG 興櫃
reserved_share	int	圈存股數餘額（股）

請求範例

auto reserved_stocks_response = sdk->stock->query_reserved_stocks(target_account);

// 搭配自定義 .cpp & hpp  Output
if (!reserved_stocks_response.is_success) {
    std::cout << "query reserved stocks failed reason: "
        << (reserved_stocks_response.message.has_value() ? reserved_stocks_response.message.value() : "No message")
        << std::endl;
}
else {
    if (reserved_stocks_response.data.has_value()) {
        for (const auto& item : reserved_stocks_response.data.value()) {
            std::cout << item << std::endl;
        }
    }
    else {
        std::cout << "Query reserved stocks success but no data returned." << std::endl;
    }
}

回傳範例

// 搭配自定義 .cpp & hpp  Output
[ReserveStockItem]
  stock_no: 2330                   // 股票代號 (string)
  market: TAIEX                    // 市場別 (Market)
  reserved_share: 5599             // 圈存股數餘額 (int)

[ReserveStockItem]
  stock_no: 1260                   // 股票代號 (string)
  market: TAIEMG                   // 市場別 (Market)
  reserved_share: 3000             // 圈存股數餘額 (int)