建立委託單

PlaceOrder

輸入參數

參數	類別	說明
account	Account	帳號
orderObject	OrderObject	委託內容
unblock	bool (optional) (default = False)	是否採用非阻塞

Result 回傳

參數	類別	說明
isSuccess	bool	是否成功
data	FutOptOrderResult	回傳委託資訊
message	string	當isSuccess = false 回傳錯誤訊息

委託資訊 FutOptOrderResult 欄位

Return type : Object

參數	類別	說明
functionType	int	功能別 : 0 新單 、10 新單執行、 15 改價、 20 改量、30刪單 、90失敗
date	string	交易日期
seqNo	string	委託單流水序號
branchNo	string	分公司代號
account	string	帳號
orderNo	string	委託書號
assetType	int	資產類別 : 1 期貨 、2 選擇權
market	string	市場類型 : TAIMEX 期貨、選擇權
marketType	FutOptMarketType	盤別種類 : Future 期貨日盤 、 Option 選擇權日盤 、 FutureNight 期貨夜盤 、 OptionNight 選擇權夜盤
unit	int	單位數
currency	string	幣別
symbol	string	商品代號
expiryDate	string	到期日
strikePrice	double	履約價
callPutLeg2	CallPut	買賣權 : Call 買權、 Put 賣權
buySell	BsAction	買賣別 : Buy 買 、 Sell 賣
symbolLeg2	string	商品代號 - 複式第二隻腳
expiryDateLeg2	string	到期日 - 複式第二隻腳
strikePriceLeg2	double	履約價 - 複式第二隻腳
callPutLeg2	CallPut	買賣權 - 複式第二隻腳 : Call 買權、 Put 賣權
buySellLeg2	BsAction	買賣別 - 複式第二隻腳: Buy 買 、 Sell 賣
priceType	FutOptPriceType	原始委託價格別 : Limit 限價 、 Market 市價 、 RangeMarket 範圍市價、Reference 參考價
price	double	價格
lot	int	原始委託股口數
timeInForce	TimeInforce	委託條件別 : Rod ROD 、 FOK FOK 、 IOC IOC
orderType	FutOptOrderType	委託單類型 : New 新倉 、 Close 平倉 、 Auto 自動 、 FdayTrade 當沖
isPreOrder	bool	是否為預約單
status	int	委託單狀態 : 0 預約單 、 4 中台收到委託 、 8 後台傳送中 、 9 後台連線逾時 、10 委託成功 、 30刪單成功 、 50 完全成交 、 90 失敗
afterPriceType	FutOptPriceType	有效委託價格別 : Limit 限價 、 Market 市價 、RangeMarket 範圍市價、 Reference 參考價
afterPrice	double	有效委託價格
afterLot	int	有效委託口數
filledLot	int	成交口數
filledMoney	double	成交價金
beforeLot	int	改單前有效口數
beforePrice	double	改單前有效價
userDef	string	自訂欄位
lastTime	string	最後異動時間
detail	list	委託歷程 (查詢OrderResultDetail or OrderHistory才有值)
errorMessage	string	錯誤訊息

請求範例

// 單式
var order = new FutOptOrder(
    BsAction.Buy,
    "TXO20000E4",
    null,
    null,
    "500",
    1,
    FutOptMarketType.Option,
    FutOptPriceType.Limit,
    TimeInForce.Rod,
    FutOptOrderType.Auto,
    "From csharp" // optional field
)

sdk.FutOpt.PlaceOrder(account, order)

// 複式
var order = new FutOptOrder(
    BsAction.Sell,
    "TXO20000E4",
    BsAction.Buy,   // optional field
    "TXO19900E4",   // optional field
    "90",
    1,
    FutOptMarketType.Option,
    FutOptPriceType.Limit,
    TimeInForce.Ioc,
    FutOptOrderType.Auto,
    "From csharp"   // optional field
)


sdk.FutOpt.PlaceOrder(account, order)

回傳範例

{   //單式回覆
    isSuccess = True,
    message = ,
    data = FutOptOrderResult {
            functionType = 0,                            // 功能別 (int)
            date = 2024/03/25,                           // 交易日期 (string)
            seqNo = 00230177010,                         // 委託單流水序號 (string)
            branchNo = 15901,                            // 分公司代號 (string)
            account = 1234567,                           // 帳號 (string)
            orderNo = C0002,                             // 委託書號 (string)
            assetType = 2,                               // 資產類別 (int)
            market = TAIMEX,                             // 市場類型 (string)
            marketType = Option,                         // 盤別種類 (FutOptMarketType)
            unit = 1,                                    // 單位數 (int)
            currency = TWD,                              // 幣別 (string)
            symbol = TXO,                                // 商品代號 (string)
            expiryDate = 202404,                         // 到期日 (string)
            strikePrice = 20000,                        // 履約價 (double)
            callPut = Call,                              // 買賣權 (string)
            buySell = Buy,                               // 買賣別 (BsAction)
            symbolLeg2 =,                                // 商品代號 - 複式第二隻腳 (string)
            expiryDateLeg2 =,                             // 到期日 - 複式第二隻腳 (string)
            strikePriceLeg2 =,                            // 履約價 - 複式第二隻腳 (double)
            callPutLeg2 =,                                // 買賣權 - 複式第二隻腳 (string)
            buySellLeg2 =,                                // 買賣別 - 複式第二隻腳 (BsAction)
            priceType = Limit,                           // 原始委託價格別 (FutOptPriceType)
            price = 500,                                 // 價格 (double)
            lot = 1,                                     // 原始委託股口數 (int)
            timeInForce = Rod,                           // 委託條件別 (TimeInforce)
            orderType = Auto,                            // 委託單類型 (FutOptOrderType)
            isPreOrder = false,                          // 是否為預約單 (bool)
            status = 10,                                 // 委託單狀態 (int)
            afterPriceType = Limit,                      // 有效委託價格別 (FutOptPriceType)
            afterPrice = 500,                            // 有效委託價格 (double)
            afterLot = 1,                                // 有效委託股口數 (int)
            filledLot = 0,                               // 成交股口數 (int)
            filledMoney = 0,                             // 成交價金 (int)
            beforeLot = 0,                               // 改單前有效股口數 (int)
            beforePrice = 500,                           // 改單前有效價格 (double)
            userDef = From csharp,                       // 自訂欄位 (string)
            lastTime = 11:50:08,                         // 最後異動時間 (string)
            errorMessage =                                 // 錯誤訊息 (string)
}}



{   //複式回覆
    isSuccess = True,
    message =,
    data  = OrderResult {
            functionType = 0,                          // 功能別 (int)
            date = 2024/03/25,                         // 交易日期 (string)
            seqNo = 00230177020,                       // 委託單流水序號 (string)
            branchNo = 15901,                          // 分公司代號 (string)
            account = 1234567,                         // 帳號 (string)
            orderNo = C0004,                           // 委託書號 (string)
            assetType = 2,                             // 資產類別 (int)
            market = TAIMEX,                           // 市場類型 (string)
            marketType = Option,                       // 盤別種類 (FutOptMarketType)
            unit = 1,                                  // 單位數 (int)
            currency = TWD,                            // 幣別 (string)
            symbol = TXO,                              // 商品代號 (string)
            expiryDate = 202405,                       // 到期日 (string)
            strikePrice = 20000,                      // 履約價 (double)
            callPut = Call,                            // 買賣權 (string)
            buySell = Sell,                            // 買賣別 (BsAction)
            symbolLeg2 = TXO,                          // 商品代號 - 複式第二隻腳 (string)
            expiryDateLeg2 = 202405,                   // 到期日 - 複式第二隻腳 (string)
            strikePriceLeg2 = 19900,                  // 履約價 - 複式第二隻腳 (double)
            callPutLeg2 = Call,                        // 買賣權 - 複式第二隻腳 (string)
            buySellLeg2 = Buy,                         // 買賣別 - 複式第二隻腳 (BsAction)
            priceType = Limit,                         // 原始委託價格別 (FutOptPriceType)
            price = 90,                                // 價格 (double)
            lot = 1,                                   // 原始委託股口數 (int)
            timeInForce = IOC,                         // 委託條件別 (TimeInforce)
            orderType = New,                           // 委託單類型 (FutOptOrderType)
            isPreOrder = false,                        // 是否為預約單 (bool)
            status = 10,                               // 委託單狀態 (int)
            afterPriceType = Limit,                    // 有效委託價格別 (FutOptPriceType)
            afterPrice = 90,                           // 有效委託價格 (double)
            afterLot = 1,                              // 有效委託股口數 (int)
            filledLot = 0,                             // 成交股口數 (int)
            filledMoney = 0,                           // 成交價金 (int)
            beforeLot = 0,                             // 改單前有效股口數 (int)
            beforePrice = 90,                          // 改單前有效價格 (double)
            userDef = From csharp,                     // 自訂欄位 (string)
            lastTime = 11:57:41,                       // 最後異動時間 (string)
            errorMessage =                             // 錯誤訊息 (string)
}}