Skip to main content

建立委託單

placeOrder

輸入參數

參數類別說明
accountAccount帳號
OrderObjectOrderObject委託內容
unblockbool ? (default = false)是否採用非阻塞

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自訂欄位 (最長10個字元,不支援特殊字元及中文、不適用興櫃)
lastTimestring最後異動時間
detailslist委託歷程 (查詢order_result_detail or order_history才有值)
errorMessagestring錯誤訊息

請求範例

const order = {
buySell: BSAction.Buy,
symbol: "2888",
price: "8.90",
quantity: 2000,
marketType: MarketType.Common,
priceType: PriceType.Limit,
timeInForce: TimeInForce.ROD,
orderType: OrderType.Stock,
userDef: "from Js"
};

sdk.stock.placeOrder(accounts.data[0],order,false);

回傳範例

{
isSuccess: true,
data:
{
functionType: 0,
date: '2023/10/23',
seqNo: '00000000016',
branchNo: '6460',
account: '26',
orderNo: 'bA716',
assetType: 0,
market: 'TAIEX',
marketType: Common,
stockNo: '2888',
buySell: Buy,
priceType: Limit,
price: 9,
quantity: 2000,
timeInForce: ROD,
orderType: 0,
isPreOrder: false,
status: 10,
afterPriceType: Limit,
afterPrice: 9,
unit: 1000,
afterQty: 2000,
filledQty: 0,
filledMoney: 0,
beforeQty: 0,
beforePrice: 9,
userDef: 'from Js',
lastTime: '13:36:38.317'
}
}