PlaceOrder

placeOrder

Request Parameter

Parameter	Type	Meaning
account	Account	Account
orderObject	OrderObject	Order Object
unblock	bool ? (default = false)	unblock

Result Response

Parameter	Type	Meaning
isSuccess	bool	Interface result
data	Object	FutOptOrderResult list is returned
message	string ? (optional)	isSuccess = False error description is returned

FutOptOrderResult Parameter

Return type : Object

Parameter	Type	Meaning
functionType	number	Function Type : 0 New 、 10 Execute New、15 Amend Price 、 20 Amend Lot 、 30 Cancel、90Failed
date	string	Transaction date
seqNo	string	Order serial number
branchNo	string	Branch number
account	string	Account
orderNo	string	Order number
assetType	number	Asset type : 1 Future 、2 Option
market	string	Market type : TAIMEX Future、Option
marketType	js:string / ts:FutOptMarketType	Trading session type : Future 、 Option 、 FutureNight After-Hour Future 、 OptionNight After-Hour Option
unit	number	Trading Unit
currency	string	Trading Currency
symbol	string	Symbol
expiryDate	string	Expiry Date
strikePrice	number	Strike Price
callPut	js:string / ts:CallPut	Call / Put Type : Call Call 、Put Put
buySell	js:string / ts:BSAction	Buy/Sell Type : Buy 、 Sell
symbolLeg2	string	Symbol - Spread Order
expiryDateLeg2	string	Expiry Date - Spread Order
strikePriceLeg2	number	Strike Price - Spread Order
callPutLeg2	js:string / ts:CallPut	Call / Put Type : Call Call 、Put Put
buySellLeg2	js:string / ts:BSAction	Buy/Sell Type : Buy 、 Sell
priceType	js:string / ts:FutOptPriceType	Original order price type : Limit 、 Market 、 RangeMarket Market with Protection Orders 、 Reference
price	number	Order Price
lot	number	Original order lot
timeInForce	js:string / ts:TimeInForce	Time In Force ROD 、 FOK 、 IOC
orderType	js:string / ts:FutOptOrderType	Order Type : New 、 Close 、 Auto 、 FdayTrade
isPreOrder	bool	Reservation Flag
status	number	Order Status : 0 Reservation 、 4 In queue 、 8 Processing by system backend 、 9 TimeOut 、 10 Active Order 、 30 Cancel Order 、 50 Fully Filled 、 90 Order Failed
afterPriceType	js:string / ts:FutOptPriceType	Valid order price type : Limit 、 Market 、 RangeMarket Market with Protection Orders 、 Reference
afterPrice	number	Valid order price
afterLot	number	Valid Order Lot
filledLot	number	Filled Lot
filledMoney	number	Filled Value
beforeLot	number	Before the Lot Modification
beforePrice	number	Before the Price Modification
userDef	string	Custom Fields
lastTime	string	Last Modification Time
details	list	Order Process (Return value when query orderResultDetail or orderHistory )
errorMessage	string	Error Message

Request Example

//Single
futoptorder = {
    buySell: BSAction.Buy,
    symbol: "TXO20000E4",
    price: "530",
    lot: 1,
    marketType: FutOptMarketType.Option,
    priceType: FutOptPriceType.Limit,
    timeInForce: TimeInForce.ROD,
    orderType: FutOptOrderType.Auto,
    userDef: "nodejs" // optional field
}

sdk.futopt.placeOrder(account, futoptorder)

// Spread
futoptorder = {
    buySell: BSAction.Sell,
    symbol: "TXO20000E4",
    buySell2: BSAction.Buy,   // optional field
    symbol2: "TXO19900E4",   // optional field
    price: "90",
    lot: 1,
    marketType: FutOptMarketType.Option,
    priceType: FutOptPriceType.Limit,
    timeInForce: TimeInForce.IOC,
    orderType: FutOptOrderType.Auto,
    userDef: "nodejs"   // optional field
}


sdk.futopt.placeOrder(account, futoptorder)

Response Example

{
  isSuccess: true,
  data:{
      functionType: 0,                       // Function Type (number): `0` New, `15` Amend Price, `20` Amend Lot, `30` Cancel
      date: "2024/03/25",                    // Transaction Date (string)
      seqNo: "00230177010",                  // Order Serial Number (string)
      branchNo: "15901",                     // Branch Number (string)
      account: "1234567",                    // Account (string)
      orderNo: "C0002",                      // Order Number (string)
      assetType: 2,                          // Asset Type (number): `1` Future, `2` Option
      market: "TAIMEX",                      // Market Type (string)
      marketType: Option,                    // Trading Session Type (FutOptMarketType): `Future`, `Option`, `FutureNight` After-Hour Future, `OptionNight` After-Hour Option
      unit: 1,                               // Unit (number)
      currency: "TWD",                       // Trading Currency (string)
      symbol: "TXO",                         // Symbol (string)
      expiryDate: "202404",                  // Expiry Date (string)
      strikePrice: 20000,                   // Strike Price (number)
      callPut: Call,                         // Call / Put (CallPut): `Call`, `Put`
      buySell: Buy,                          // Buy/Sell Type (BSAction): `Buy`, `Sell`
      priceType: Limit,                      // Original Order Price Type (FutOptPriceType): `Limit`, `Market`, `RangeMarket` Market with Protection Orders, `Reference`
      price: 530,                            // Order Price (number)
      lots: 1,                               // Original Order Lot (number)
      timeInForce: ROD,                      // Time In Force (TimeInforce): `ROD`, `FOK`, `IOC`
      orderType: Auto,                       // Order Type (FutOptOrderType): `New`, `Close`, `Auto`, `FdayTrade` DayTrade
      isPreOrder: false,                     // Reservation Order Flag (bool)
      status: 10,                            // Order Status (number): `0` Reservation, `4` InQueue, `9` TimeOut, `10` New Order, `30` Cancel Order, `50` Fully Filled, `90` Order Failed
      afterPriceType: Limit,                 // Valid Order Price Type (FutOptPriceType): `Limit`, `Market`, `RangeMarket` Market with Protection Orders, `Reference`
      afterPrice: 530,                       // Valid Order Price (number)
      afterLot: 1,                           // Valid Order Lot (number)
      filledLot: 0,                          // Filled Lot (number)
      filledMoney: 0,                        // Filled Value (number)
      beforeLot: 0,                          // Before the Lot Modification (number)
      beforePrice: 530,                      // Before the Price Modification (number)
      userDef: "nodejs",                // Custom Fields (string)
      lastTime: "11:50:08",                  // Last Modification Time (string)
}
}