批次修改委託價格
batch_modify_price
先使用make_modify_price_obj 建立 FutOptModifyPrice 物件
| 參數 | 類別 | 說明 |
|---|---|---|
| orderResult | FutOptOrderResult | 預計修改的委託單 |
| price | string | 修改後的價格 |
| priceType | FutOptPriceType | 修改後的價格旗標 |
caution
當 price 欄位有填入值時，priceType 欄位為空值或為None ； 當 priceType 欄位有填入值時，price 欄位為空值或為None
將回傳的物件放入 modify_price 的方法中
輸入參數
| 參數 | 類別 | 說明 |
|---|---|---|
| account | Account | 帳號 |
| ModifyPriceObj | FutOptModifyPrice (list) | 批次修改委託單內容 |
Result 回傳
| 參數 | 類別 | 說明 |
|---|---|---|
| is_success | bool | 是否成功 |
| data | List | 回傳修改資訊 |
| message | string | 當is_success = false 回傳錯誤訊息 |
修改資訊 FutOptOrderResult 欄位
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 | 資產類別 : 1 期貨 、2 選擇權 |
| market | string | 市場類型 : TAIMEX 期貨、選擇權 |
| market_type | FutOptMarketType | 盤別種類 : Future 期貨日盤 、 Option 選擇權日盤 、 FutureNight 期貨夜盤 、 OptionNight 選擇權夜盤 |
| unit | int | 單位數 |
| currency | string | 幣別 |
| symbol | string | 商品代號 |
| expiry_date | string | 到期日 |
| strike_price | float | 履約價 |
| call_put | CallPut | 買賣權 : Call 買權、 Put 賣權 |
| buy_sell | BSAction | 買賣別 : Buy 買 、 Sell 賣 |
| symbol_leg2 | string | 商品代號 - 複式第二隻腳 |
| expiry_date_leg2 | string | 到期日 - 複式第二隻腳 |
| strike_price_leg2 | float | 履約價 - 複式第二隻腳 |
| call_put_leg2 | CallPut | 買賣權 - 複式第二隻腳 : Call 買權、 Put 賣權 |
| buy_sell_leg2 | BSAction | 買賣別 - 複式第二隻腳: Buy 買 、 Sell 賣 |
| price_type | FutOptPriceType | 原始委託價格別 : Limit 限價 、 Market 市價 、 RangeMarket 範圍市價、Reference 參考價 |
| price | float | 價格 |
| lot | int | 原始委託股口數 |
| time_in_force | TimeInforce | 委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC |
| order_type | FutOptOrderType | 委託單類型 : New 新倉 、 Close 平倉 、 Auto 自動 、 FdayTrade 當沖 |
| is_pre_order | bool | 是否為預約單 |
| status | int | 委託單狀態 : 0 預約單 、 4 中台收到委託 、 8 後台傳送中 、 9 後台連線逾時 、10 委託成功 、 30刪單成功 、 50 完全成交 、 90 失敗 |
| after_price_type | FutOptPriceType | 有效委託價格別 : Limit 限價 、 Market 市價 、RangeMarket 範圍市價、 Reference 參考價 |
| after_price | float | 有效委託價格 |
| after_lot | int | 有效委託口數 |
| filled_lot | int | 成交口數 |
| filled_money | float | 成交價金 |
| before_lot | int | 改單前有效口數 |
| before_price | float | 改單前有效價 |
| user_def | string | 自訂欄位 |
| last_time | string | 最後異動時間 |
| detail | list | 委託歷程 (查詢order_result_detail or order_history才有值) |
| error_message | string | 錯誤訊息 |
請求範例
# 批次改價(利用batch detail回傳的內容改單)
modify_objects = [
sdk.futopt.make_modify_price_obj(batch_results_detail.data[0], "19900"),
sdk.futopt.make_modify_price_obj(batch_results_detail.data[1], "19900"),
]
sdk.futopt.batch_modify_price(target_user, modify_objects)
# 批次改價(利用不同的單筆委託)
modify_objects = [
sdk.futopt.make_modify_price_obj(orders.data[37], "19900"),
sdk.futopt.make_modify_price_obj(orders.data[35], "19900"),
]
sdk.futopt.batch_modify_price(target_user, modify_objects)
回傳範例
Result {
is_success: True,
message: None,
data : [ FutOptOrderResult{# 批次改價(利用batch detail回傳的內容改單)
function_type: 15, # 功能別 (int)
date: "2024/03/25", # 交易日期 (string)
seq_no: "00110212663", # 委託單流水序號 (string)
branch_no: "15901", # 分公司代號 (string)
account: "1234567", # 帳號 (string)
order_no: "C0005", # 委託書號 (string)
asset_type: 1, # 資產類別 (int)
market: "TAIMEX", # 市場類型 (string)
market_type: Future, # 盤別種類 (FutOptMarketType)
unit: None, # 單位數 (int)
currency: "TWD", # 幣別 (string)
symbol: "FITX", # 商品代號 (string)
expiry_date: "0", # 到期日 (string)
strike_price: 0, # 履約價 (float)
call_put: None, # 買賣權 (CallPut)
buy_sell: Buy, # 買賣別 (BSAction)
symbol_leg2: None, # 商品代號 - 複式第二隻腳 (string)
expiry_date_leg2: None, # 到期日 - 複式第二隻腳 (string)
strike_price_leg2: None, # 履約價 - 複式第二隻腳 (float)
call_put_leg2: None, # 買賣權 - 複式第二 隻腳 (CallPut)
buy_sell_leg2: None, # 買賣別 - 複式第二隻腳 (BSAction)
price_type: Limit, # 原始委託價格別 (FutOptPriceType)
price: 20000, # 價格 (float)
lot: 1, # 原 始委託股口數 (int)
time_in_force: ROD, # 委託條件別 (TimeInforce)
order_type: New, # 委託單類型 (FutOptOrderType)
is_pre_order: False, # 是否為預約單 (bool)
status: 10, # 委託單狀態 (int)
after_price_type: Limit, # 有效委託價格別 (FutOptPriceType)
after_price: 19900, # 有效委託價格 (float)
after_lot: 1, # 有效委託股口數 (int)
filled_lot: 0, # 成交股口數 (int)
filled_money: 0, # 成交價金 (int)
before_lot: 0, # 改單前有效股口數 (int)
before_price: 20000, # 改單前有效價格 (float)
user_def: None, # 自訂欄位 (string)
last_time: "13:39:05", # 最後異動時間 (string)
details: None, # 委託歷程 (list)
error_message: None, # 錯誤訊息 (string)
},
FutOptOrderResult{
function_type: 15, # 功能別 (int)
date: "2024/03/25", # 交易日期 (string)
seq_no: "00110212664", # 委託單流水序號 (string)
branch_no: "15901", # 分公司代號 (string)
account: "1234567", # 帳號 (string)
order_no: "C0006", # 委託書號 (string)
asset_type: 1, # 資產類別 (int)
market: "TAIMEX", # 市場類型 (string)
market_type: Future, # 盤別種類 (FutOptMarketType)
unit: None, # 單位數 (int)
currency: "TWD", # 幣別 (string)
symbol: "FITX", # 商品代號 (string)
expiry_date: "0", # 到期日 (string)
strike_price: 0, # 履約價 (float)
call_put: None, # 買賣權 (CallPut)
buy_sell: Buy, # 買賣別 (BSAction)
symbol_leg2: None, # 商品代號 - 複式第二隻腳 (string)
expiry_date_leg2: None, # 到期日 - 複式第二隻腳 (string)
strike_price_leg2: None, # 履約價 - 複式第二隻腳 (float)
call_put_leg2: None, # 買賣權 - 複式第二隻腳 (CallPut)
buy_sell_leg2: None, # 買賣別 - 複式第二隻腳 (BSAction)
price_type: Limit, # 原始委託價格別 (FutOptPriceType)
price: 20000, # 價格 (float)
lot: 1, # 原始委託股口數 (int)
time_in_force: ROD, # 委託條件別 (TimeInforce)
order_type: New, # 委託單類型 (FutOptOrderType)
is_pre_order: False, # 是否為預約單 (bool)
status: 10, # 委託單狀態 (int)
...
}]
}
以下範例擷取data內容
[ FutOptOrderResult{# 批次改價(利用不同的單筆委託)
function_type: 15, # 功能別 (int)
date: "2024/03/25", # 交易日期 (string)
seq_no: "00110212665", # 委託單流水序號 (string)
branch_no: "15901", # 分公司代號 (string)
account: "1234567", # 帳號 (string)
order_no: "C0006", # 委託書號 (string)
asset_type: 1, # 資產類別 (int)
market: "TAIMEX", # 市場類型 (string)
market_type: Future, # 盤別種類 (FutOptMarketType)
unit: None, # 單位數 (int)
currency: "TWD", # 幣別 (string)
symbol: "FITX", # 商品代號 (string)
expiry_date: "0", # 到期日 (string)
strike_price: 0, # 履約價 (float)
call_put: None, # 買賣權 (CallPut)
buy_sell: Buy, # 買賣別 (BSAction)
symbol_leg2: None, # 商品代號 - 複式第二隻腳 (string)
expiry_date_leg2: None, # 到期日 - 複式第二隻腳 (string)
strike_price_leg2: None, # 履約價 - 複式第二隻腳 (float)
call_put_leg2: None, # 買賣權 - 複式第二隻腳 (CallPut)
buy_sell_leg2: None, # 買賣別 - 複式第二隻腳 (BSAction)
price_type: Limit, # 原始委託價格別 (FutOptPriceType)
price: 20000, # 價格 (float)
lot: 1, # 原始委託股口數 (int)
time_in_force: ROD, # 委託條件別 (TimeInforce)
order_type: New, # 委託單類型 (FutOptOrderType)
is_pre_order: False, # 是否為預約單 (bool)
status: 10, # 委託單狀態 (int)
after_price_type: Limit, # 有效委託價格別 (FutOptPriceType)
after_price: 19900, # 有效委託價格 (float)
after_lot: 1, # 有效委託股口數 (int)
filled_lot: 0, # 成交股口數 (int)
filled_money: 0, # 成交價金 (int)
before_lot: 0, # 改單前有效股口數 (int)
before_price: 20000, # 改單前有效價格 (float)
user_def: None, # 自訂欄位 (string)
last_time: "13:39:10", # 最後異動時間 (string)
error_message: None, # 錯誤訊息 (string)
},
FutOptOrderResult{
function_type: 15, # 功能別 (int)
date: "2024/03/25", # 交易日期 (string)
seq_no: "00110212665", # 委託單流水序號 (string)
branch_no: "15901", # 分公司代號 (string)
account: "1234567", # 帳號 (string)
order_no: "C0007", # 委託書號 (string)
asset_type: 1, # 資產類別 (int)
market: "TAIMEX", # 市場類型 (string)
market_type: Future, # 盤別種類 (FutOptMarketType)
unit: None, # 單位數 (int)
currency: "TWD", # 幣別 (string)
symbol: "FITX", # 商品代號 (string)
expiry_date: "0", # 到期日 (string)
strike_price: 0, # 履約價 (float)
call_put: None, # 買賣權 (CallPut)
buy_sell: Buy, # 買賣別 (BSAction)
symbol_leg2: None, # 商品代號 - 複式第二隻腳 (string)
expiry_date_leg2: None, # 到期日 - 複式第二隻腳 (string)
strike_price_leg2: None, # 履約價 - 複式第二隻腳 (float)
call_put_leg2: None, # 買賣權 - 複式第二隻腳 (CallPut)
buy_sell_leg2: None, # 買賣別 - 複式第二隻腳 (BSAction)
price_type: Limit, # 原始委託價格別 (FutOptPriceType)
price: 20000, # 價格 (float)
lot: 1, # 原始委託股口數 (int)
time_in_force: ROD, # 委託條件別 (TimeInforce)
order_type: New, # 委託單類型 (FutOptOrderType)
is_pre_order: False, # 是否為預約單 (bool)
status: 10, # 委託單狀態 (int)
...
}]