查詢歷史委託
orderHistory
輸入參數
| 參數 | 類別 | 說明 |
|---|---|---|
| account | Account | 帳號 |
| startDate | string | 查詢開始日 |
| endDate | string? (空值預設與開始日相同) | 查詢終止日 |
info
v2.1.1起可查詢長期歷史資料，每次查詢最大設定30日日期區間；v2.1.0之前版本可查詢最近兩日之歷史資料
Result 回傳
| 參數 | 類別 | 說明 |
|---|---|---|
| isSuccess | bool | 是否成功 |
| data | Object | 回傳委託資訊 |
| message | string ? (optional) | 當isSuccess = false 回傳錯誤訊息 |
委託資訊 OrderResult 欄位
Return type : Object
| Parameter | Type | Meaning |
|---|---|---|
| functionType | number ? (Optional) | 功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗 |
| date | string | 交易日期 |
| seqNo | string | 委託單流水序號 |
| branchNo | string | 分公司代號 |
| account | string | 帳號 |
| orderNo | string | 委託書號 |
| assetType | number | 資產類別 : 0 證券 |
| market | string | 市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票 |
| marketType | js:string / ts:MarketType | 盤別種類 : Common 整股 、 Fixing 定盤 、 IntradayOdd 盤中零股 、 Odd 盤後零股 、 Emg 興櫃 、 EmgOdd 興櫃零股 |
| stockNo | string | 股票代號 |
| buySell | js:string / ts:BSAction | 買賣別 : Buy 買 、 Sell 賣 |
| priceType | js:string / ts:PriceType | 原始委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價 |
| price | number | 價格 |
| quantity | number | 原始委託股數 |
| timeInForce | js:string / ts:TimeInForce | 委託條件別 : ROD ROD 、 FOK FOK 、 IOC IOC |
| orderType | js:string / ts:OrderType | 委託單類型 : Stock 現股 、 Margin 融資 、 Short 融券 、 DayTrade 現股當沖 、 SBL借券 |
| isPreOrder | bool | 是否為預約單 |
| status | number | 委託單狀態 : 0 預約單 、 4 系統將委託送往後台 、 9 連線逾時 、10 委託成功 、 30未成交刪單成功 、 40部分成交，剩餘取消 、 50 完全成交 、 90 失敗 |
| afterPriceType | js:string / ts:[PriceType] (/docs/trading/library/nodejs/EnumMatrix/#pricetype) | 有效委託價格別 : Limit 限價 、 LimitUp 漲停 、 LimitDown 跌停 、 Market 市價 、 Reference 參考價 |
| afterPrice | number | 有效委託價格 |
| unit | number | 單位數 |
| afterQty | number | 有效委託股數（包含已成交部分） |
| filledQty | number | 成交股數 |
| filledMoney | number | 成交價金 |
| beforeQty | number | 改單前有效量 |
| beforePrice | number | 改單前有效價 |
| lastTime | string | 最後異動時間 |
| errorMessage | string | 錯誤訊息 |
| details | list | 委託歷程 (查詢orderResultDetail or orderHistory才有值) |
| >> functionType | number | 功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 50 完全成交 、 90失敗 |
| >> modifiedTime | string | 修改時間 |
| >> beforeQty | number | 原始委託股數 |
| >> afterQty | number | 有效委託股數（包含已成交部分） |
| >> beforePrice | number | 原始委託價 |
| >> afterPrice | number | 有效委託價 |
| >> filledMoney | number | 成交價金 |
| >> status | number | 委託單狀態 |
| >> errMsg | string | 錯誤訊息 |
請求範例
const orderHistory = sdk.stock.orderHistory(account,"20230921","20231020");
console.log(orderHistory);
回傳範例
{
isSuccess: true,
data:[
{
date: '2023/10/11',
seqNo: '00005000001',
branchNo: '6460',
account: '26',
orderNo: 'bA586',
assetType: 0,
market: 'TAIEX',
marketType: Common,
stockNo: '2888',
buySell: Buy,
priceType: Limit,
price: 8.9,
quantity: 2000,
timeInForce: ROD,
orderType: Stock,
isPreOrder: false,
status: 10,
afterPrice: 8.51,
unit: 1000,
afterQty: 2000,
filledQty: 0,
filledMoney: 0,
userDef: 'From Js',
lastTime: '11:25:08.761',
details:[
functionType: 10,
modifiedTime: '11:25:08.761',
beforeQty: 0,
afterQty: 2000,
beforePrice: 8.51,
afterPrice: 8.51
]
},
...
]
}