Transfer Record Query

QueryTransfers

Version

Available in v2.2.9 and later.

Parameters

Field	Type	Description
account	Account	Account
start_date	string (optional)	Query start date (YYYYMMDD). When omitted, the server default range is used
end_date	string (optional)	Query end date (YYYYMMDD)
stock_no	string (optional)	Stock symbol. When omitted, all symbols are queried

Result

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

Transfer record: TransferRecord fields

Return type : Object

Field	Type	Description
seq_no	string	Sequence number
date	string	Application date
time	string	Application time
stock_no	string	Stock symbol
market	Market	Market: TAIEX TWSE, TAISDAQ TPEx, TAIEMG Emerging
quantity	int	Transferred shares
target_branch_no	string	Receiving branch code
target_account	string	Receiving account
status	int	Status: 10 success; 90 failure

Request example

auto transfers_response = sdk->stock->query_transfers(target_account, "20260701", "20260722", std::nullopt);


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

Response example

// Output using custom .cpp and .hpp helpers
[TransferRecord]
  seq_no: 418181                   // Sequence number (string)
  date: 2026/07/28                 // Application date (string)
  time: 10:53:48.340               // Application time (string)
  stock_no: 006205                   // Stock symbol (string)
  market: TAIEX                    // Market (Market)
  quantity: 1000                   // transferred shares (int)
  target_branch_no: 960C           // Receiving branch code (string)
  target_account: 7654321          // Receiving account (string)
  status: 10                       // status (int)