Skip to main content

查詢歷史委託

orderHistory

輸入參數

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

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

Result 回傳

參數類別說明
isSuccessbool是否成功
dataObject回傳委託資訊
messagestring ? (optional)當isSuccess = false 回傳錯誤訊息

委託資訊 FutOptOrderResult 欄位

Return type : Object

參數類別說明
functionTypenumber (Optional)功能別 : 0 新單 、10 新單執行、 15 改價、 20 改量、30刪單 、90失敗
datestring交易日期
seqNostring委託單流水序號
branchNostring分公司代號
accountstring帳號
orderNostring委託書號
assetTypenumber資產類別 : 1 期貨 、2 選擇權
marketstring市場類型 : TAIMEX 期貨、選擇權
marketTypejs:string / ts:FutOptMarketType盤別種類 : Future 期貨日盤 、 Option 選擇權日盤 、 FutureNight 期貨夜盤 、 OptionNight 選擇權夜盤
unitnumber單位數
currencystring幣別
symbolstring商品代號
expiryDatestring到期日
strikePricenumber履約價
callPutjs:string / ts:CallPut買賣權 : Call 買權、 Put 賣權
buySelljs:string / ts:BSAction買賣別 : Buy 買 、 Sell
symbolLeg2string商品代號 - 複式第二隻腳
expiryDateLeg2string到期日 - 複式第二隻腳
strikePriceLeg2number履約價 - 複式第二隻腳
callPutLeg2js:string / ts:CallPut買賣權 : Call 買權、 Put 賣權
buySellLeg2js:string / ts:BSAction買賣別 - 複式第二隻腳: Buy 買 、 Sell
priceTypejs:string / ts:FutOptPriceType原始委託價格別 : Limit 限價 、 Market 市價 、 RangeMarket 範圍市價、Reference 參考價
pricenumber價格
lotnumber原始委託股口數
timeInForcejs:string / ts:TimeInforce委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC
orderTypejs:string / ts:FutOptOrderType委託單類型 : New 新倉 、 Close 平倉 、 Auto 自動 、 FdayTrade 當沖
isPreOrderbool是否為預約單
statusnumber委託單狀態 : 0 預約單 、 4 中台收到委託 、 8 後台傳送中 、 9 後台連線逾時 、10 委託成功 、 30刪單成功 、 50 完全成交 、 90 失敗
afterPriceTypejs:string / ts:FutOptPriceType有效委託價格別 : Limit 限價 、 Market 市價 、RangeMarket 範圍市價、 Reference 參考價
afterPricenumber有效委託價格
afterLotnumber有效委託口數
filledLotnumber成交口數
filledMoneynumber成交價金
beforeLotnumber改單前有效口數
beforePricenumber改單前有效價
userDefstring自訂欄位
lastTimestring最後異動時間
detaillist委託歷程
>> functionTypenumber功能別 : 10 新單、15 改價、 20 改量、30刪單、50 成交、90失敗
>> modifiedTimestring修改時間
>> beforeLotnumber原始委託口數
>> afterLotnumber有效委託口數
>> beforePricenumber原始委託價
>> afterPricenumber有效委託價
>> errorMessagestring錯誤訊息
errorMessagestring錯誤訊息

請求範例

const orderHistory = sdk.stock.orderHistory(account,"20230921","20231020");
console.log(orderHistory);

回傳範例

{
isSuccess: true,
data:[
{
date: "2024/04/11", // 交易日期 (string)
seqNo: "00230177314", // 委託單流水序號 (string)
branchNo: "15000", // 分公司代號 (string)
account: "9974825", // 帳號 (string)
orderNo: "C0020", // 委託書號 (string)
assetType: 2, // 資產類別 : `1` 期貨 、`2` 選擇權 (number)
market: "TAIMEX", // 市場類型 : `TAIMEX` 期貨、選擇權 (string)
marketType: "Option", // 盤別種類 : `Future` 期貨日盤 、 `Option` 選擇權日盤 、 `FutureNight` 期貨夜盤 、 `OptionNight` 選擇權夜盤 (FutOptMarketType)
symbol: "TXO", // 商品代號 (string)
expiryDate: "202404", // 到期日 (string)
strikePrice: 18600, // 履約價 (number)
callPut: "Call", // 買賣權 : `Call` 買權、 `Put` 賣權 (string)
buySell: "Buy", // 買賣別 : `Buy` 買 、 `Sell` 賣 (BSAction)
priceType: "Limit", // 原始委託價格別 : `Limit` 限價 、 `Market` 市價 、 `RangeMarket` 範圍市價、`Reference` 參考價 (PriceType)
price: 2100, // 價格 (number)
lot: 1, // 原始委託股口數 (number)
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` 失敗 (number)
afterPrice: 2100, // 有效委託價格 (number)
afterLot: 1, // 有效委託口數 (number)
filledLot: 1, // 成交口數 (number)
filledMoney: 2100, // 成交價金 (number)
lastTime: "10:41:46.760", // 最後異動時間 (string)
details:[
functionType: 10, // 功能別 (number)
modifiedTime: "10:20:27", // 修改時間 (string)
beforeLot: 0, // 原始委託口數 (number)
afterLot: 1, // 有效委託口數 (number)
beforePrice: 2100, // 原始委託價格 (number)
afterPrice: 2100, // 有效委託價格 (number)
]
....
},

{
date: "2024/04/11", // 交易日期 (string)
seqNo: "00230177315", // 委託單流水序號 (string)
branchNo: "15000", // 分公司代號 (string)
account: "9974825", // 帳號 (string)
orderNo: "C0021", // 委託書號 (string)
assetType: 2, // 資產類別 : `1` 期貨 、`2` 選擇權 (number)
market: "TAIMEX", // 市場類型 : `TAIMEX` 期貨、選擇權 (string)
marketType: "Option", // 盤別種類 : `Future` 期貨日盤 、 `Option` 選擇權日盤 、 `FutureNight` 期貨夜盤 、 `OptionNight` 選擇權夜盤 (FutOptMarketType)
symbol: "TXO", // 商品代號 (string)
expiryDate: "202404", // 到期日 (string)
strikePrice: 18500, // 履約價 (number)
callPut: "Call", // 買賣權 : `Call` 買權、 `Put` 賣權 (string)
buySell: "Sell", // 買賣別 : `Buy` 買 、 `Sell` 賣 (BSAction)
priceType: "Limit", // 原始委託價格別 : `Limit` 限價 、 `Market` 市價 、 `RangeMarket` 範圍市價、`Reference` 參考價 (PriceType)
price: 2230, // 價格 (number)
lot: 1, // 原始委託股口數 (number)
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` 失敗 (number)
afterPrice: 2230, // 有效委託價格 (number)
afterLot: 1, // 有效委託口數 (number)
filledLot: 1, // 成交口數 (number)
filledMoney: 2230, // 成交價金 (number)
lastTime: "10:41:46.760", // 最後異動時間 (string)
}
]
}