Skip to main content

查詢歷史委託

OrderHistory

輸入參數

參數類別說明
accountAccount帳號
startDatestring查詢開始日
endDatestring查詢終止日
marketTypeFutOptMarketType (Optioanl : 不帶全盤別)盤別種類 : Future 期貨日盤 、 FutureNight 期貨夜盤 、 Option 選擇權日盤 、 OptionNight 選擇權夜盤
info

可查詢最近兩日之歷史資料

Result 回傳

參數類別說明
isSuccessbool是否成功
dataList回傳委託資訊
messagestring當isSuccess = False 回傳錯誤訊息

委託資訊 FutOptOrderResult 欄位

Return type : Object

參數類別說明
functionTypeint (Optional)功能別 : 0 新單 、10 新單執行、 15 改價、 20 改量、30刪單 、90失敗
datestring交易日期
seqNostring委託單流水序號
branchNostring分公司代號
accountstring帳號
orderNostring委託書號
assetTypeint資產類別 : 1 期貨 、2 選擇權
marketstring市場類型 : TAIMEX 期貨、選擇權
marketTypeFutOptMarketType盤別種類 : Future 期貨日盤 、 Option 選擇權日盤 、 FutureNight 期貨夜盤 、 OptionNight 選擇權夜盤
unitint單位數
currencystring幣別
symbolstring商品代號
expiryDatestring到期日
strikePricedouble履約價
callPutLeg2CallPut買賣權 : Call 買權、 Put 賣權
buySellBsAction買賣別 : Buy 買 、 Sell
symbolLeg2string商品代號 - 複式第二隻腳
expiryDateLeg2string到期日 - 複式第二隻腳
strikePriceLeg2double履約價 - 複式第二隻腳
callPutLeg2CallPut買賣權 - 複式第二隻腳 : Call 買權、 Put 賣權
buySellLeg2BsAction買賣別 - 複式第二隻腳: Buy 買 、 Sell
priceTypeFutOptPriceType原始委託價格別 : Limit 限價 、 Market 市價 、 RangeMarket 範圍市價、Reference 參考價
pricedouble價格
lotint原始委託股口數
timeInForceTimeInforce委託條件別 : Rod ROD 、 FOK FOK 、 IOC IOC
orderTypeFutOptOrderType委託單類型 : New 新倉 、 Close 平倉 、 Auto 自動 、 FdayTrade 當沖
isPreOrderbool是否為預約單
statusint委託單狀態 : 0 預約單 、 4 中台收到委託 、 8 後台傳送中 、 9 後台連線逾時 、10 委託成功 、 30刪單成功 、 50 完全成交 、 90 失敗
afterPriceTypeFutOptPriceType有效委託價格別 : Limit 限價 、 Market 市價 、RangeMarket 範圍市價、 Reference 參考價
afterPricedouble有效委託價格
afterLotint有效委託口數
filledLotint成交口數
filledMoneydouble成交價金
beforeLotint改單前有效口數
beforePricedouble改單前有效價
userDefstring自訂欄位
lastTimestring最後異動時間
errorMessagestring錯誤訊息
detaillist委託歷程
>> functionTypeint功能別 : 10 新單、15 改價、 20 改量、30刪單、50 成交 、90失敗
>> modifiedTimestring修改時間
>> beforeLotint原始委託口數
>> afterLotint有效委託口數
>> beforePricedouble原始委託價
>> afterPricedouble有效委託價
>> filledMoneydouble成交價金
>> errorMessagestring錯誤訊息

請求範例

Console.WriteLine(sdk.FutOpt.OrderHistory(account,"20230921","20230922"));

回傳範例

{
isSuccess = True,
message = ,
data = [ FutOptOrderResult{
functionType = , // 功能別 (int)
date = 2024/04/11, // 交易日期 (string)
seqNo = 00230177314, // 委託單流水序號 (string)
branchNo = 15000, // 分公司代號 (string)
account = 9974825, // 帳號 (string)
orderNo = C0020, // 委託書號 (string)
assetType = 2, // 資產類別 : `1` 期貨 、`2` 選擇權 (int)
market = TAIMEX, // 市場類型 : `TAIMEX` 期貨、選擇權 (string)
marketType = Option, // 盤別種類 : `Future` 期貨日盤 、 `Option` 選擇權日盤 、 `FutureNight` 期貨夜盤 、 `OptionNight` 選擇權夜盤 (FutOptMarketType)
unit = , // 單位數 (int)
currency = , // 幣別 (string)
symbol = TXO, // 商品代號 (string)
expiryDate = 202404, // 到期日 (string)
strikePrice = 18600, // 履約價 (double)
callPut = Call, // 買賣權 : `Call` 買權、 `Put` 賣權 (string)
buySell = Buy, // 買賣別 : `Buy` 買 、 `Sell` 賣 (BsAction)
symbolLeg2 = , // 商品代號 - 複式第二隻腳 (string)
expiryDateLeg2 = , // 到期日 - 複式第二隻腳 (string)
strikePriceLeg2 = , // 履約價 - 複式第二隻腳 (double)
callPutLeg2 = , // 買賣權 - 複式第二隻腳 : `Call` 買權、 `Put` 賣權 (string)
buySellLeg2 = , // 買賣別 - 複式第二隻腳: `Buy` 買 、 `Sell` 賣 (BsAction)
priceType = Limit, // 原始委託價格別 : `Limit` 限價 、 `Market` 市價 、 `RangeMarket` 範圍市價、`Reference` 參考價 (FutOptPriceType)
price = 2100, // 價格 (double)
lot = 1, // 原始委託股口數 (int)
timeInForce = ROD, // 委託條件別 : `ROD` ROD 、 `FOK` FOK 、 `IOC` IOC (TimeInforce)
orderType = New, // 委託單類型 : `New` 新倉 、 `Close` 平倉 、 `Auto` 自動 、 `FdayTrade` 當沖 (FutOptOrderType)
isPreOrder = false, // 是否為預約單 (bool)
status = 50, // 委託單狀態 : `0` 預約單 、 `4` 中台收到委託 、`9` 後台連線逾時 、`10` 委託成功 、 `30`刪單成功 、 `50` 完全成交 、 `90` 失敗 (int)
afterPriceType = , // 有效委託價格別 : `Limit` 限價 、 `Market` 市價 、`RangeMarket` 範圍市價、 `Reference` 參考價 (FutOptPriceType)
afterPrice = 2100, // 有效委託價格 (double)
afterLot = 1, // 有效委託口數 (int)
filledLot = 1, // 成交口數 (int)
filledMoney = 2100, // 成交價金 (double)
beforeLot = , // 改單前有效口數 (int)
beforePrice = , // 改單前有效價 (double)
userDef = , // 自訂欄位 (string)
lastTime = 10:41:46.760, // 最後異動時間 (string)
detail = [ // 委託歷程 (List)
OrderDetail{
functionType = 10, // 功能別 (int)
modifiedTime = 10:20:27, // 修改時間 (string)
beforeLot = 0, // 原始委託口數 (int)
afterLot = 2, // 有效委託口數 (int)
beforePrice = 1822.6, // 原始委託價格 (double)
afterPrice = 1822.6 // 有效委託價格 (double)
errorMessage = // 錯誤訊息 (string)
}
]
errorMessage = // 錯誤訊息 (string)
},
FutOptOrderResult{
functionType = , // 功能別 (int)
date = 2024/04/11, // 交易日期 (string)
seqNo = 00230177315, // 委託單流水序號 (string)
branchNo = 15000, // 分公司代號 (string)
account = 9974825, // 帳號 (string)
orderNo = C0021, // 委託書號 (string)
assetType = 2, // 資產類別 : `1` 期貨 、`2` 選擇權 (int)
market = TAIMEX, // 市場類型 : `TAIMEX` 期貨、選擇權 (string)
marketType = Option, // 盤別種類 : `Future` 期貨日盤 、 `Option` 選擇權日盤 、 `FutureNight` 期貨夜盤 、 `OptionNight` 選擇權夜盤 (FutOptMarketType)
unit = , // 單位數 (int)
currency = , // 幣別 (string)
symbol = TXO, // 商品代號 (string)
expiryDate = 202404, // 到期日 (string)
strikePrice = 18500, // 履約價 (double)
callPut = Call, // 買賣權 : `Call` 買權、 `Put` 賣權 (string)
buySell = Sell, // 買賣別 : `Buy` 買 、 `Sell` 賣 (BsAction)
symbolLeg2 = , // 商品代號 - 複式第二隻腳 (string)
expiryDateLeg2 = , // 到期日 - 複式第二隻腳 (string)
strikePriceLeg2 = , // 履約價 - 複式第二隻腳 (double)
callPutLeg2 = , // 買賣權 - 複式第二隻腳 : `Call` 買權、 `Put` 賣權 (string)
buySellLeg2 = , // 買賣別 - 複式第二隻腳: `Buy` 買 、 `Sell` 賣 (BsAction)
priceType = Limit, // 原始委託價格別 : `Limit` 限價 、 `Market` 市價 、 `RangeMarket` 範圍市價、`Reference` 參考價 (FutOptPriceType)
price = 2230, // 價格 (double)
lot = 1, // 原始委託股口數 (int)
timeInForce = ROD, // 委託條件別 : `ROD` ROD 、 `FOK` FOK 、 `IOC` IOC (TimeInforce)
orderType = New, // 委託單類型 : `New` 新倉 、 `Close` 平倉 、 `Auto` 自動 、 `FdayTrade` 當沖 (FutOptOrderType)
isPreOrder = false, // 是否為預約單 (bool)
status = 50, // 委託單狀態 : `0` 預約單 、 `4` 中台收到委託 、`9` 後台連線逾時 、`10` 委託成功 、 `30`刪單成功 、 `50` 完全成交 、 `90` 失敗 (int)
afterPriceType = , // 有效委託價格別 : `Limit` 限價 、 `Market` 市價 、`RangeMarket` 範圍市價、 `Reference` 參考價 (FutOptPriceType)
afterPrice = 2230, // 有效委託價格 (double)
afterLot = 1, // 有效委託口數 (int)
filledLot = 1, // 成交口數 (int)
filledMoney = 2230, // 成交價金 (double)
beforeLot = , // 改單前有效口數 (int)
beforePrice = , // 改單前有效價 (double)
userDef = , // 自訂欄位 (string)
lastTime = 10:41:46.760, // 最後異動時間 (string)
errorMessage = // 錯誤訊息 (string)
},
...
]
}