Transferable Inventory Query

QueryTransferInventory

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 transferable inventory; an empty list when no records exist
message	string	Error message when is_success is false

Transferable inventory: TransferInventoryItem fields

Return type : Object

Field	Type	Description
stock_no	string	Stock symbol
market	Market	Market: TAIEX TWSE, TAISDAQ TPEx, TAIEMG Emerging
available_share	int	Transferable shares

Request example

auto transfer_inventory_response = sdk->stock->query_transfer_inventory(target_account);


// Output using custom .cpp and .hpp helpers
if (!transfer_inventory_response.is_success) {
    std::cout << "query transfer inventory failed reason: "
        << (transfer_inventory_response.message.has_value() ? transfer_inventory_response.message.value() : "No message")
        << std::endl;
}
else {
    if (transfer_inventory_response.data.has_value()) {
        for (const auto& item : transfer_inventory_response.data.value()) {
            std::cout << item << std::endl;
        }
    }
    else {
        std::cout << "Query transfer inventory success but no data returned." << std::endl;
    }
}

Response example

// Output using custom .cpp and .hpp helpers
[TransferInventoryItem]
  stock_no: 2331                   // Stock symbol (string)
  market: TAIEX                    // Market (Market)
  available_share: 5000            // Transferable shares (int)