Skip to main content

批次修改委託數量

batchModifyQuantity

先使用 makeModifyQuantityObj 建立一個 ModifyQuantityObj 物件

參數類別說明
orderResultorderResult預計修改的委託單
quantitynumber改單後的委託量 ( 修改後數量包含此委託單已成交部份 )

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

輸入參數

參數類別說明
accountAccount帳號
ModifyQuantityObjModifyQuantityObj (list of object)批次改量委託單內容

Result 回傳

參數類別說明
isSuccessbool是否成功
dataObject回傳修改資訊
messagestring ? (optional)當isSuccess = false 回傳錯誤訊息

修改資訊 OrderResult 欄位

Return type : Object

ParameterTypeMeaning
functionTypenumber功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗
datestring交易日期
seqNostring委託單流水序號
branchNostring分公司代號
accountstring帳號
orderNostring委託書號
assetTypenumber資產類別 : 0 證券
marketstring市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票
marketTypejs:string / ts:MarketType盤別種類 : Common 整股 、 Fixing 定盤 、 IntradayOdd 盤中零股 、 Odd 盤後零股 、 Emg 興櫃 、 EmgOdd 興櫃零股
stockNostring股票代號
buySelljs:string / ts:BSAction買賣別 : Buy 買 、 Sell
priceTypejs:string / ts:PriceType原始委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
pricenumber價格
quantitynumber原始委託股數
timeInForcejs:string / ts:TimeInForce委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC
orderTypejs:string / ts:OrderType委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現股當沖 、 SBL借券
isPreOrderbool是否為預約單
statusnumber委託單狀態 : 0 預約單 、 4 系統將委託送往後台 、 9 連線逾時 、10 委託成功 、 30未成交刪單成功 、 40部分成交,剩餘取消 、 50 完全成交 、 90 失敗
afterPriceTypejs:string / ts:PriceType有效委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價
afterPricenumber有效委託價格
unitnumber單位數
afterQtynumber有效委託股數(包含已成交部分)
filledQtynumber成交股數
filledMoneynumber成交價金
beforeQtynumber改單前有效量
beforePricenumber改單前有效價
user_defstring自訂欄位
lastTimestring最後異動時間
detailslist委託歷程 (查詢order_result_detail or order_history才有值)
errorMessagestring錯誤訊息

請求範例

// 批次改量(利用batch detail回傳的內容改單)
modify_orders = [
sdk.stock.makeModifyQuantityObj(batch_res.data[0], 1000),
sdk.stock.makeModifyQuantityObj(batch_res.data[1], 1000)
]

sdk.stock.batchModifyQuantity(account, modify_orders);


// # 批次改量(利用不同的單筆委託)
modify_orders = [
sdk.stock.makeModifyQuantityObj(orderResult.data[22], 1000),
sdk.stock.makeModifyQuantityObj(orderResult.data[40], 1000)
]

sdk.stock.batchModifyQuantity(account, modify_orders);


回傳範例

{
isSuccess: true,
data: [ // 批次改量(利用batch detail回傳的內容改單)
{
functionType: 20, // 功能別 (number)
date: '2024/03/08', // 交易日期 (string)
seqNo: '00000000042', // 委託單流水序號 (string)
branchNo: '20112', // 分公司代號 (string)
account: '26', // 帳號 (string)
orderNo: 'x0026', // 委託書號 (string)
assetType: 0, // 資產類別 (number)
market: 'TAIEX', // 市場類型 (string)
marketType: 'Common', // 盤別種類 (string)
stockNo: '2881', // 股票代號 (string)
buySell: 'Buy', // 買賣別 (string)
priceType: 'Limit', // 原始委託價格別 (string)
price: 66, // 價格 (number)
quantity: 2000, // 原始委託股數 (number)
timeInForce: 'ROD', // 委託條件別 (string)
orderType: 'Stock', // 委託單類型 (string)
isPreOrder: false, // 是否為預約單 (bool)
status: 10, // 委託單狀態 (number)
afterPrice: 66, // 有效委託價格 (number)
unit: 1000, // 單位數 (number)
afterQty: 1000, // 有效委託股數 (number)
filledQty: 0, // 成交股數 (number)
filledMoney: 0, // 成交價金 (number)
beforeQty: 2000, // 改單前有效量 (number)
userDef: 'batch 2', // 自訂欄位 (string)
lastTime: '12:21:51.023', // 最後異動時間 (string)
},
{
functionType: 20, // 功能別 (number)
date: '2024/03/08', // 交易日期 (string)
seqNo: '00000000041', // 委託單流水序號 (string)
branchNo: '20112', // 分公司代號 (string)
account: '26', // 帳號 (string)
orderNo: 'x0025', // 委託書號 (string)
assetType: 0, // 資產類別 (number)
market: 'TAIEX', // 市場類型 (string)
marketType: 'Common', // 盤別種類 (string)
stockNo: '2881', // 股票代號 (string)
buySell: 'Buy', // 買賣別 (string)
priceType: 'Limit', // 原始委託價格別 (string)
price: 66, // 價格 (number)
quantity: 2000, // 原始委託股數 (number)
timeInForce: 'ROD', // 委託條件別 (string)
orderType: 'Stock', // 委託單類型 (string)
isPreOrder: false, // 是否為預約單 (bool)
status: 10, // 委託單狀態 (number)
afterPrice: 66, // 有效委託價格 (number)
unit: 1000, // 單位數 (number)
afterQty: 1000, // 有效委託股數 (number)
filledQty: 0, // 成交股數 (number)
filledMoney: 0, // 成交價金 (number)
beforeQty: 2000, // 改單前有效量 (number)
userDef: 'batch 1', // 自訂欄位 (string)
lastTime: '12:21:51.023', // 最後異動時間 (string)
}
]
}

以下擷取data內容

[ // 批次改量(利用不同的單筆委託)
{
functionType: 20, // 功能別 (number)
date: '2024/03/08', // 交易日期 (string)
seqNo: '00000000043', // 委託單流水序號 (string)
branchNo: '20112', // 分公司代號 (string)
account: '26', // 帳號 (string)
orderNo: 'x0027', // 委託書號 (string)
assetType: 0, // 資產類別 (number)
market: 'TAIEX', // 市場類型 (string)
marketType: 'Common', // 盤別種類 (string)
stockNo: '2881', // 股票代號 (string)
buySell: 'Buy', // 買賣別 (string)
priceType: 'Limit', // 原始委託價格別 (string)
price: 66, // 價格 (number)
quantity: 2000, // 原始委託股數 (number)
timeInForce: 'Rod', // 委託條件別 (string)
orderType: 'Stock', // 委託單類型 (string)
isPreOrder: false, // 是否為預約單 (bool)
status: 10, // 委託單狀態 (number)
afterPrice: 66, // 有效委託價格 (number)
unit: 1000, // 單位數 (number)
afterQty: 1000, // 有效委託股數 (number)
filledQty: 0, // 成交股數 (number)
filledMoney: 0, // 成交價金 (number)
beforeQty: 2000, // 改單前有效量 (number)
userDef: 'Test', // 自訂欄位 (string)
lastTime: '12:21:53.023', // 最後異動時間 (string)
},
{
functionType: 20, // 功能別 (number)
date: '2024/03/08', // 交易日期 (string)
seqNo: '00000000044', // 委託單流水序號 (string)
branchNo: '20112', // 分公司代號 (string)
account: '26', // 帳號 (string)
orderNo: 'x0028', // 委託書號 (string)
assetType: 0, // 資產類別 (number)
market: 'TAIEX', // 市場類型 (string)
marketType: 'Common', // 盤別種類 (string)
stockNo: '2881', // 股票代號 (string)
buySell: 'Buy', // 買賣別 (string)
priceType: 'Limit', // 原始委託價格別 (string)
price: 66, // 價格 (number)
quantity: 2000, // 原始委託股數 (number)
timeInForce: 'Rod', // 委託條件別 (string)
orderType: 'Stock', // 委託單類型 (string)
isPreOrder: false, // 是否為預約單 (bool)
status: 10, // 委託單狀態 (number)
afterPrice: 66, // 有效委託價格 (number)
unit: 1000, // 單位數 (number)
afterQty: 1000, // 有效委託股數 (number)
filledQty: 0, // 成交股數 (number)
filledMoney: 0, // 成交價金 (number)
beforeQty: 2000, // 改單前有效量 (number)
userDef: 'Test', // 自訂欄位 (string)
lastTime: '12:21:53.023', // 最後異動時間 (string)
}
]