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)
// optional field
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
{ // Single-leg order response
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: 500, // Order Price (number)
lot: 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: 500, // 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: 500, // Before the Price Modification (number)
userDef: "nodejs", // Custom Fields (string)
lastTime: "11:50:08", // Last Modification Time (string)
}}
{ // Spread order response
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: "00230177020", // Order Serial Number (string)
branchNo: "15901", // Branch Number (string)
account: "1234567", // Account (string)
orderNo: "C0004", // 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: "202405", // Expiry Date (string)
strikePrice: 20000, // Strike Price (number)
callPut: Call, // Call / Put (CallPut): `Call`, `Put`
buySell: Sell, // Buy/Sell Type (BSAction): `Buy`, `Sell`
symbolLeg2: "TXO", // Symbol - second leg of spread order (string)
expiryDateLeg2: "202405", // Expiry date - second leg of spread order (string)
strikePriceLeg2: 199000, // Strike price - second leg of spread order (number)
callPutLeg2: Call, // Call/put - second leg of spread order (string)
buySellLeg2: Buy, // Buy/sell side - second leg of spread order (BSAction)
priceType: Limit, // Original Order Price Type (FutOptPriceType): `Limit`, `Market`, `RangeMarket` Market with Protection Orders, `Reference`
price: 90, // Order Price (number)
lot: 1, // Original order lot (number)
timeInForce: IOC, // 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: 90, // 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: 90, // Before the Price Modification (number)
userDef: "nodejs", // Custom Fields (string)
lastTime: "11:57:41", // Last Modification Time (string)
}
}