批次修改委託價格

batch_modify_price

先使用make_modify_price_obj 建立 ModifyPriceObj 物件

參數	類別	說明
order	OrderResult	預計修改的委託單
price	string	修改後的價格
price_type	PriceType	修改後的價格旗標 (註: 輕量風控版已開放使用價格旗標)

caution

當 price 欄位有填入值時，priceType 欄位為空值或為None ； 當 priceType 欄位有填入值時，price 欄位為空值或為None

將回傳的物件放入 modify_price 的方法中

輸入參數

參數	類別	說明
account	Account	帳號
orders	ModifyPriceObj (list)	批次修改委託單內容

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	List	回傳修改資訊
message	string	當is_success = false 回傳錯誤訊息

修改資訊 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 定盤 、 IntradayOdd 盤中零股 、 Odd 盤後零股 、 Emg 興櫃 、 EmgOdd 興櫃零股
stock_no	string	股票代號
buy_sell	BSAction	買賣別 : Buy 買 、 Sell 賣
price_type	PriceType	原始委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
price	float	價格
quantity	int	原始委託股數
time_in_force	TimeInforce	委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC
order_type	OrderType	委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現沖先賣 、 SBL借券
is_pre_order	bool	是否為預約單
status	int	委託單狀態，詳細列表請參考 STATUS
after_price_type	PriceType	有效委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
after_price	float	有效委託價格
unit	int	單位數
after_qty	int	有效委託股數（包含已成交部分）
filled_qty	int	成交股數
filled_money	int	成交價金
before_qty	int	改單前有效量
before_price	float	改單前有效價
user_def	string	自訂欄位
last_time	string	最後異動時間
details	list	委託歷程 (查詢order_result_detail or order_history才有值)
error_message	string	錯誤訊息

請求範例

# 批次改價(利用batch detail回傳的內容改單)
modify_objects = [
    sdk.stock.make_modify_price_obj(batch_results_detail.data[0], "41.1"),
    sdk.stock.make_modify_price_obj(batch_results_detail.data[1], "41.2"),
]
sdk.stock.batch_modify_price(target_user, modify_objects)


# 批次改價(利用不同的單筆委託)
modify_objects = [
    sdk.stock.make_modify_price_obj(orders.data[37], "41.1"),
    sdk.stock.make_modify_price_obj(orders.data[35], "41.2"),
]

sdk.stock.batch_modify_price(target_user, modify_objects)

回傳範例

Result {
    is_success: True,
    message: None,
    data : [ OrderResult{# 批次改價(利用batch detail回傳的內容改單)
                function_type: 15,          # 功能別 (int)
                date: "2023/11/22",         # 交易日期 (string)
                seq_no: "00000322356",      # 委託單流水序號 (string)
                branch_no: "6460",          # 分公司代號 (string)
                account: "26",              # 帳號 (string)
                order_no: "x0018",          # 委託書號 (string)
                asset_type: 0,              # 資產類別 (int)
                market: "TAIEX",            # 市場類型 (string)
                market_type: Common,        # 盤別種類 (MarketType)
                stock_no: "1101",           # 股票代號 (string)
                buy_sell: Sell,             # 買賣別 (BSAction)
                price_type: Limit,          # 原始委託價格別 (PriceType)
                price: 41.2,                # 價格 (float)
                quantity: 5000,             # 原始委託股數 (int)
                time_in_force: ROD,         # 委託條件別 (TimeInForce)
                order_type: Stock,          # 委託單類型 (OrderType)
                is_pre_order: False,        # 是否為預約單 (bool)
                status: 10,                 # 委託單狀態 (int)
                after_price_type: Limit,    # 有效委託價格別 (PriceType)
                after_price: 41.1,          # 有效委託價格 (float)
                unit: 1000,                 # 單位數 (int)
                after_qty: 2000,            # 有效委託股數 (int)
                filled_qty: 0,              # 成交股數 (int)
                filled_money: 0,            # 成交價金 (int)
                before_qty: None,           # 改單前有效量 (int)
                before_price: 41.3,         # 改單前有效價 (float)
                user_def: "12345678",       # 自訂欄位 (string)
                last_time: "13:56:57.713",  # 最後異動時間 (string)
                details: None,               # 委託歷程 (list)
                error_message: None         # 錯誤訊息 (string)
                },
          OrderResult{
                function_type: 15,          # 功能別 (int)
                date: "2023/11/22",         # 交易日期 (string)
                seq_no: "00000322355",      # 委託單流水序號 (string)
                branch_no: "6460",          # 分公司代號 (string)
                account: "26",              # 帳號 (string)
                order_no: "x0017",          # 委託書號 (string)
                asset_type: 0,              # 資產類別 (int)
                market: "TAIEX",            # 市場類型 (string)
                market_type: Common,        # 盤別種類 (MarketType)
                stock_no: 1101,             # 股票代號 (string)
                buy_sell: Sell,             # 買賣別 (BSAction)
                price_type: Limit,          # 原始委託價格別 (PriceType)
                price: 41.2,                # 價格 (float)
                quantity: 5000,             # 原始委託股數 (int)
                time_in_force: ROD,         # 委託條件別 (TimeInForce)
                order_type: Stock,          # 委託單類型 (OrderType)
                is_pre_order: False,        # 是否為預約單 (bool)
                status: 10,                 # 委託單狀態 (int)
                ...
        }]
}


以下範例擷取data內容

[   OrderResult{# 批次改價(利用不同的單筆委託)
                function_type: 15,          # 功能別 (int)
                date: "2023/11/22",         # 交易日期 (string)
                seq_no: "00000322388",      # 委託單流水序號 (string)
                branch_no: "6460",          # 分公司代號 (string)
                account: "26",              # 帳號 (string)
                order_no: "x0033",          # 委託書號 (string)
                asset_type: 0,              # 資產類別 (int)
                market: "TAIEX",            # 市場類型 (string)
                market_type: Common,        # 盤別種類 (MarketType)
                stock_no: 1101,             # 股票代號 (string)
                buy_sell: Sell,             # 買賣別 (BSAction)
                price_type: Limit,          # 原始委託價格別 (PriceType)
                price: 41.2,                # 價格 (float)
                quantity: 5000,             # 原始委託股數 (int)
                time_in_force: ROD,         # 委託條件別 (TimeInForce)
                order_type: Stock,          # 委託單類型 (OrderType)
                is_pre_order: False,        # 是否為預約單 (bool)
                status: 10,                 # 委託單狀態 (int)
                after_price_type: Limit,    # 有效委託價格別 (PriceType)
                after_price: 41.1,          # 有效委託價格 (float)
                unit: 1000,                 # 單位數 (int)
                after_qty: 2000,            # 有效委託股數 (int)
                filled_qty: 0,              # 成交股數 (int)
                filled_money: 0,            # 成交價金 (int)
                before_qty: None,           # 改單前有效量 (int)
                before_price: 41.3,         # 改單前有效價 (float)
                user_def: "12345678",       # 自訂欄位 (string)
                last_time: "10:56:57.713",  # 最後異動時間 (string)
                details: None,               # 委託歷程 (list)
                error_message: None         # 錯誤訊息 (string)
    },
    OrderResult{
                function_type: 15,          # 功能別 (int)
                date: "2023/11/22",         # 交易日期 (string)
                seq_no: "00000322386",      # 委託單流水序號 (string)
                branch_no: "6460",          # 分公司代號 (string)
                account: "26",              # 帳號 (string)
                order_no: "x0031",          # 委託書號 (string)
                asset_type: 0,              # 資產類別 (int)
                market: "TAIEX",            # 市場類型 (string)
                market_type: Common,        # 盤別種類 (MarketType)
                stock_no: "1101",           # 股票代號 (string)
                buy_sell: Sell,             # 買賣別 (BSAction)
                price_type: Limit,          # 原始委託價格別 (PriceType)
                price: 41.2,                # 價格 (float)
                quantity: 5000,             # 原始委託股數 (int)
                time_in_force: ROD,         # 委託條件別 (TimeInForce)
                order_type: Stock,          # 委託單類型 (OrderType)
                is_pre_order: False,        # 是否為預約單 (bool)
                status: 10,                 # 委託單狀態 (int)
                ...
}]