匯撥紀錄查詢

QueryTransfers

版本資訊

v2.2.9 起新增功能

輸入參數

參數	類別	說明
account	Account	帳號
start_date	string (optional)	查詢起日（YYYYMMDD），未帶入時依伺服器預設區間
end_date	string (optional)	查詢止日（YYYYMMDD）
stock_no	string (optional)	股票代號，未帶入時查詢全部

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	List	回傳匯撥紀錄列表，查無資料時為空列表
message	string	當is_success = false 回傳錯誤訊息

匯撥紀錄 TransferRecord 欄位

Return type : Object

參數	類別	說明
seq_no	string	委託單流水序號
date	string	申請日期
time	string	申請時間
stock_no	string	股票代號
market	Market	市場別 : TAIEX 上市 、 TAISDAQ 上櫃 、 TAIEMG 興櫃
quantity	int	匯撥股數（股）
target_branch_no	string	撥入方分公司代號
target_account	string	撥入方帳號
status	int	狀態碼 : 10 成功 、 90 失敗

請求範例

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


// 搭配自定義 .cpp & hpp  Output
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;
    }
}

回傳範例

// 搭配自定義 .cpp & hpp  Output
[TransferRecord]
  seq_no: 418181                   // 委託單流水序號 (string)
  date: 2026/07/28                 // 申請日期 (string)
  time: 10:53:48.340               // 申請時間 (string)
  stock_no: 006205                   // 股票代號 (string)
  market: TAIEX                    // 市場別 (Market)
  quantity: 1000                   // 匯撥股數 (int)
  target_branch_no: 960C           // 撥入方分公司代號 (string)
  target_account: 7654321          // 撥入方帳號 (string)
  status: 10                       // 狀態碼 (int)