Query Order History

orderHistory

Input Parameters

Parameter	Type	Meaning
account	Account	Account
startDate	string	Query Start Date
endDate	string? (null or empty will equals startDate)	Query End Date

info

Since v2.1.1, this supports longer term historical data inquiry. The day range is limited maximum 30 days per request. For older SDK versions (until v2.1.0), it supports historical data for the past two days.

Result

Parameter	Type	Meaning
isSuccess	bool	Whether successful
data	Object	OrderResult list is returned
message	string ? (optional)	Error message returned when isSuccess = false

OrderResult Parameter

Return type : Object

Parameter	Type	Meaning
functionType	number ? (Optional)	Function Type : 0 New Order, 10 New Order Executed, 15 Change Price, 20 Change Quantity, 30 Cancel, 90 Failed
date	string	Transaction date
seqNo	string	Order serial number
branchNo	string	Branch number
account	string	Account
orderNo	string	Order number
assetType	number	Asset type : 0 Stock
market	string	Market type : TAIEX Listed, TAISDAQ OTC, TAIEMG EMG
marketType	js:string / ts:MarketType	Trading session type : Common, Fixing, IntradayOdd, Odd, Emg, EmgOdd
stockNo	string	Symbol
buySell	js:string / ts:BSAction	Buy/Sell Type : Buy, Sell
priceType	js:string / ts:PriceType	Original order price type : Limit, LimitUp, LimitDown, Market, Reference
price	number	Order Price
quantity	number	Original order quantity
timeInForce	js:string / ts:TimeInForce	Time In Force ROD, FOK, IOC
orderType	js:string / ts:OrderType	Order Type : Stock, Margin, Short Short sale, DayTrade, SBL
isPreOrder	bool	Reservation Flag
status	number	Order status, for details please refer to STATUS
afterPriceType	js:string / ts:PriceType	Valid order price type : Limit, LimitUp, LimitDown, Market, Reference
afterPrice	number	Valid order price
unit	number	Trading Unit
afterQty	number	Valid Order Quantity (filled quantity included)
filledQty	number	Filled Quantity
filledMoney	number	Filled Value
beforeQty	number	Before the Quantity Modification
beforePrice	number	Before the Price Modification
lastTime	string	Last Modification Time
errorMessage	string	Error Message
details	list	Order Process
>> functionType	number	Function Type : 0 New Order, 10 New Order Executed, 15 Change Price, 20 Change Quantity, 30 Cancel, 50 Fully Filled, 90 Failed
>> modifiedTime	string	Order Modified Time
>> beforeQty	number	Original Order Quantity
>> afterQty	number	Valid Order Quantity (filled quantity included)
>> beforePrice	number	Original Order Price
>> afterPrice	number	Valid Order Price
>> filledMoney	number	Filled Value
>> status	number	Order Status
>> errMsg	string	Error Message

Request Example

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

Response Example

{
  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: 'FromJs',
      lastTime: '11:25:08.761',
      details:[
        functionType: 10,
        modifiedTime: '11:25:08.761',
        beforeQty: 0,
        afterQty: 2000,
        beforePrice: 8.51,
        afterPrice: 8.51
      ]
    },
    ...
  ]
}