批次修改委託數量
batchModifyQuantity
先使用 makeModifyQuantityObj 建立一個 ModifyQuantityObj 物件
參數 | 類別 | 說明 |
---|---|---|
orderResult | orderResult | 預計修改的委託單 |
quantity | number | 改單後的委託量 ( 修改後數量包含此委託單已成交部份 ) |
將回傳的物件放入batchModifyQuantity 方法中
輸入參數
參數 | 類別 | 說明 |
---|---|---|
account | Account | 帳號 |
ModifyQuantityObj | ModifyQuantityObj (list of object) | 批次改量委託單內容 |
Result 回傳
參數 | 類別 | 說明 |
---|---|---|
isSuccess | bool | 是否成功 |
data | Object | 回傳修改資訊 |
message | string ? (optional) | 當isSuccess = false 回傳錯誤訊息 |
修改資訊 OrderResult 欄位
Return type : Object
Parameter | Type | Meaning |
---|---|---|
functionType | number | 功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗 |
date | string | 交易日期 |
seqNo | string | 委託單流水序號 |
branchNo | string | 分公司代號 |
account | string | 帳號 |
orderNo | string | 委託書號 |
assetType | number | 資產類別 : 0 證券 |
market | string | 市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票 |
marketType | js:string / ts:MarketType | 盤別種類 : Common 整股 、 Fixing 定盤 、 IntradayOdd 盤中零股 、 Odd 盤後零股 、 Emg 興櫃 、 EmgOdd 興櫃零股 |
stockNo | string | 股票代號 |
buySell | js:string / ts:BSAction | 買賣別 : Buy 買 、 Sell 賣 |
priceType | js:string / ts:PriceType | 原始委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價 |
price | number | 價格 |
quantity | number | 原始委託股數 |
timeInForce | js:string / ts:TimeInForce | 委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC |
orderType | js:string / ts:OrderType | 委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現股當沖 、 SBL 借券 |
isPreOrder | bool | 是否為預約單 |
status | number | 委託單狀態 : 0 預約單 、 4 系統將委託送往後台 、 9 連線逾時 、10 委託成功 、 30 未成交刪單成功 、 40 部分成交,剩餘取消 、 50 完全成交 、 90 失敗 |
afterPriceType | js:string / ts:PriceType | 有效委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價 |
afterPrice | number | 有效委託價格 |
unit | number | 單位數 |
afterQty | number | 有效委託股數(包含已成交部分) |
filledQty | number | 成交股數 |
filledMoney | number | 成交價金 |
beforeQty | number | 改單前有效量 |
beforePrice | number | 改單前有效價 |
user_def | string | 自訂欄位 |
lastTime | string | 最後異動時間 |
details | list | 委託歷程 (查詢order_result_detail or order_history才有值) |
errorMessage | string | 錯誤訊息 |
請求範例
// 批次改量(利用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)
}
]