Share Reservation Query

QueryReservedStocks

Version

Available in v2.2.9 and later.

Parameters

Field	Type	Description
account	Account	Account

Result

Field	Type	Description
is_success	bool	Whether the request succeeded
data	List	List of reserved shares; an empty list when no records exist
message	string	Error message when is_success is false

Reserved-share balance: ReserveStockItem fields

Return type : Object

Field	Type	Description
stock_no	string	Stock symbol
market	Market	Market: TAIEX TWSE, TAISDAQ TPEx, TAIEMG Emerging
reserved_share	int	Reserved-share balance (shares)

Request example

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

// Output using custom .cpp and .hpp helpers
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;
    }
}

Response example

// Output using custom .cpp and .hpp helpers
[ReserveStockItem]
  stock_no: 2330                   // Stock symbol (string)
  market: TAIEX                    // Market (Market)
  reserved_share: 5599             // Reserved-share balance (int)

[ReserveStockItem]
  stock_no: 1260                   // Stock symbol (string)
  market: TAIEMG                   // Market (Market)
  reserved_share: 3000             // Reserved-share balance (int)