歷史移動鎖利查詢

get_trail_history

輸入參數

參數	類別	說明
account	Account	帳號
start_date	string	查詢開始日
end_date	string	查詢截止日

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	list	條件單回傳資訊
message	string ? (optional)	當isSuccess = false 回傳錯誤訊息

委託資訊 ConditionDetail 欄位

Return type : Object

參數	類別	說明
guid	string	條件單號
batch_no	string	分單批號
order_level	string	條件單層級
last_time	string	更新時間
parent_guid	string	父單單號
symbol	string	商品代號
order_amount	string	委託金額
child_batch_no	string	子單分單批號
account	string	帳號
condition_content	string	條件內容
action	string	處理方式
condition_buy_sell	string	買賣別
condition_symbol	string	商品名稱
condition_price	string	價格
condition_volume	string	委託數量
condition_filled_volume	string	成交數量
create_time	string	建立時間
start_date	string	預約開始時間
status	string	目前狀態
error_message	string	目前狀態異常說明
detail_records_count	string	查詢明細筆數
detail_records	List	查詢明細資料
>> guid	string	條件單號
>> account	string	帳號
>> condition_content	string	條件內容
>> action	string	處理方式
>> condition_buy_sell	string	買賣別
>> condition_symbol	string	商品名稱
>> condition_price	string	價格
>> condition_volume	string	委託數量
>> condition_filled_volume	string	成交數量
>> start_date	string	預約時間
>> status	string	目前狀態
>> error_message	string	目前狀態異常說明
tpsl_count	string	停損停利筆數
tpsl_record	List	停損停利明細資料
>> guid	string	條件單號
>> account	string	帳號
>> condition_content	string	條件內容
>> action	string	處理方式
>> condition_buy_sell	string	買賣別
>> condition_symbol	string	商品名稱
>> condition_price	string	價格
>> condition_volume	string	委託數量
>> condition_filled_volume	string	成交數量
>> start_date	string	預約時間
>> status	string	目前狀態
>> error_message	string	目前狀態異常說明

請求範例

auto get_trail_his = sdk->stock->get_trail_history(target_account, "20250601", "20250606");
if (!get_trail_his.is_success) {
    std::cout << "get order result failed reason: "
        << (get_trail_his.message.has_value() ? get_trail_his.message.value() : "No message")
        << std::endl;
}
else {
    if (get_trail_his.data.has_value()) {
        for (const auto& result : get_trail_his.data.value()) {
            std::cout << result << std::endl;
        }
    }
    else {
        std::cout << "Order result success but no data returned." << std::endl;
    }
}

回傳範例

{
    isSuccess = True,
    message = ,
    data = [
            ConditionDetail {
                Guid = 5c154a76-e7ef-4b8f-94b5-80bf08fa4b8e,
                BatchNo = ,
                OrderLevel = 0,
                LastTime = 2024-08-02 16:45:01,
                ConditionType = ,
                ParentGuid = ,
                Symbol = 2889,
                OrderAmount = 0,
                ChildBatchNo = ,
                Account = 1307515,
                ConditionContent = 從2024/08/02到2024/08/02內當國票金從1000(原始基準價)，下跌達10%，持續至預定張數全部成交或期限到達為止,
                Action = 下單,
                ConditionBuySell = 現股買,
                ConditionSymbol = 國票金 (2889),
                ConditionPrice = 成交價(1) 檔(ROD),
                ConditionVolume = 1張,
                ConditionFilledVolume = 0張,
                CreateTime = 2024-08-02 10:07:31,
                StartDate = 2024/08/02,
                Status = 條件單中止(I),
                ErrorMessage = null,
                DetailRecordsCount = 0,
                DetailRecords = [],
                TpslCount = 0,
                TpslRecord = []
            },
            ConditionDetail
            {
                Guid = c71117c8-aa70-4477-9f04-ff4c73a4fad0,
                BatchNo = "",
                OrderLevel = 0,
                LastTime = 2024-07-29 17:30:00,
                ConditionType = ,
                ParentGuid = ,
                Symbol = 2330,
                OrderAmount = 0,
                ChildBatchNo = "",
                Account = 1307515,
                ConditionContent = 從2024/07/29到2024/07/29內當台積電從860(原始基準價)，上漲達5%，持續至預定張數全部成交或期限到達為止,
                Action = 下單,
                ConditionBuySell = 現股買,
                ConditionSymbol = 台積電 (2330),
                ConditionPrice = 成交價(5) 檔(ROD),
                ConditionVolume = 2張,
                ConditionFilledVolume = 0張,
                CreateTime = 2024-07-29 11:01:49,
                StartDate = 2024/07/29,
                Status = 條件單中止(I),
                ErrorMessage = null,
                DetailRecordsCount = 0,
                DetailRecords = [],
                TpslCount = 0,
                TpslRecord = []
            }
    ]
}