建立批次委託單

batch_place_order

輸入參數

參數	類別	說明
account	Account	帳號
OrderObject	OrderObject (list of object)	委託內容

Result 回傳

參數	類別	說明
is_success	bool	是否成功
message	string	當isSuccess = False 回傳錯誤訊息
data	List	回傳委託資訊

委託資訊 OrderResult 欄位

Return type : Object

參數	類別	說明
function_type	int	功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗
date	string	交易日期
seq_no	string	委託單流水序號
branch_no	string	分公司代號
account	string	帳號
order_no	string	委託書號
asset_type	int	資產類別 : 0 證券
market	string	市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票
market_type	MarketType	盤別種類 : COMMON 整股 、 FIXING 定盤 、 INTRADAY_ODD 盤中零股 、 ODD 盤後零股 、 EMG 興櫃 、 EMG_ODD 興櫃零股
stock_no	string	股票代號
buy_sell	BSAction	買賣別 : BUY 買 、 SELL 賣
pric_type	PriceType	有效委託價格別 : LIMIT 限價 、 LIMIT_UP 漲停 、 LIMIT_DOWN 跌停 、 MARKET 市價 、 REFERENCE 參考價
price	double	價格
quantity	int	原始委託股數
time_in_force	TimeInForce	委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC
order_type	OrderType	委託單類型 : STOCK 現股 、 MARGIN 融資 、 SHORT 融券 、 DAY_TRADE 現股當沖 、 SBL借券
is_pre_order	bool	是否為預約單
status	int	委託單狀態 : 0 預約單 、 4 系統將委託送往後台 、 9 連線逾時 、10 委託成功 、 30未成交刪單成功 、 40部分成交，剩餘取消 、 50 完全成交 、 90 失敗
after_price_type	PriceType	有效委託價格別 : LIMIT 限價 、 LIMIT_UP 漲停 、 LIMIT_DOWN 跌停 、 MARKET 市價 、 REFERENCE 參考價
after_price	double	有效委託價格
unit	int	單位數
after_qty	int	有效委託股數（包含已成交部分）
filled_qty	int	成交股數
filled_money	int	成交價金
before_qty	int	改單前有效量
before_price	double	改單前有效價
user_def	string	自訂欄位
last_time	string	最後異動時間
details	list	委託歷程 (查詢order_result_detail or order_history才有值)
error_message	string	錯誤訊息

請求範例

Order order = Order{
    BsAction::BUY,
    "1101",
    std::nullopt,
    1,
    MarketType::INTRADAY_ODD,
    PriceType::LIMIT_DOWN,
    TimeInForce::ROD,
    OrderType::STOCK,
    "c++"
};

Order order2 = Order{
    BsAction::BUY,
    "1101",
    std::nullopt,
    1,
    MarketType::INTRADAY_ODD,
    PriceType::LIMIT_DOWN,
    TimeInForce::ROD,
    OrderType::STOCK,
    "c++"
};

std::vector<Order> orders;
orders.push_back(order);
orders.push_back(order2);


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

回傳範例

{
    isSuccess = true,
    message = ,
    data =  [ OrderResult{
                functionType = 0,                // 功能別 (int)
                date = 2023/09/22,             // 交易日期 (string)
                seqNo = 00000221431,           // 委託單流水序號 (string)
                branchNo = 6460,               // 分公司代號 (string)
                account = 26,                  // 帳號 (string)
                orderNo = ,                    // 委託書號 (string)
                market = TAIEX,                // 市場類型 (string)
                marketType = Common,           // 盤別種類 (MarketType)
                stock_no = 2888,               // 股票代號 (string)
                buy_sell = Buy,                // 買賣別 (BsAction)
                priceType = Limit,             // 原始委託價格別 (PriceType)
                price = 8.9,                   // 價格 (double)
                quantity = 2000,               // 原始委託股數 (int)
                timeInForce = Rod,             // 委託條件別 (TimeInforce)
                orderType = Stock,             // 委託單類型 (OrderType)
                isPreOrder = true,             // 是否為預約單 (bool)
                status = 0,                    // 委託單狀態 (int)
                afterPriceType = Limit,        // 有效委託價格別 (PriceType)
                afterPrice = 8.9,              // 有效委託價格 (double)
                unit = 1000,                   // 單位數 (int)
                afterQty = 2000,               // 有效委託股數 (int)
                filledQty = 0,                 // 成交股數 (int)
                filledMoney = 0,               // 成交價金 (int)
                beforeQty = 0,                 // 異動前有效量 (int)
                beforePrice = 9.1,             // 異動前有效價 (double)
                userDef = null,                // 自定義欄位 (string)
                lastTime = null,               // 最後異動時間 (string)
                details = ,                     // 委託歷程 (list)
                errorMessage =                 // 錯誤訊息 (string)
            },
            OrderResult{
                functionType = 0,              // 功能別 (int)
                date = 2023/09/22,             // 交易日期 (string)
                seqNo = 00000221432,           // 委託單流水序號 (string)
                branchNo = 6460,               // 分公司代號 (string)
                account = 26,                  // 帳號 (string)
                orderNo = ,                    // 委託書號 (string)
                market = TAIEX,                // 市場類型 (string)
                marketType = Common,           // 盤別種類 (MarketType)
                stock_no = 2888,               // 股票代號 (string)
                buy_sell = Buy,                // 買賣別 (BsAction)
                priceType = Limit,             // 原始委託價格別 (PriceType)
                price = 8.9,                   // 價格 (double)
                quantity = 2000,               // 原始委託股數 (int)
                timeInForce = Rod,             // 委託條件別 (TimeInforce)
                orderType = Stock,             // 委託單類型 (OrderType)
                isPreOrder = true,             // 是否為預約單 (bool)
                status = 0,                    // 委託單狀態 (int)
                afterPriceType = Limit,        // 有效委託價格別 (PriceType)
                afterPrice = 8.9,              // 有效委託價格 (double)
                unit = 1000,                   // 單位數 (int)
                afterQty = 2000,               // 有效委託股數 (int)
                filledQty = 0,                 // 成交股數 (int)
                filledMoney = 0,               // 成交價金 (int)
                beforeQty = 0,                 // 異動前有效量 (int)
                beforePrice = 9.1,             // 異動前有效價 (double)
                userDef = ,                    // 自定義欄位 (string)
                lastTime =,                    // 最後異動時間 (string)
                details = ,                     // 委託歷程 (list)
                errorMessage =                 // 錯誤訊息 (string)
            }
    ] 
}