Skip to main content

Get Historical Order

order_history

Request Parameter

ParameterTypeMeaning
accountsAccountAccount
start_datestringQuery start date
end_datestringQuery end date
market_typeFutOptMarketType (Optional : If not specified, it includes all)Trading Session Type : FutureOptionFutureNight After-Hour Future、 OptionNight After-Hour Option
info

Support historical data for the past two days

Result Response

ParameterTypeMeaning
is_successboolInterface result
dataListFutOptOrderResult list is returned
messagestringis_success = False error description is returned

FutOptOrderResult Parameter

Return type : Object

ParameterTypeMeaning
function_typeint (optional)Function Type : 0 New 、 10 Execute New、15 Amend Price 、 20 Amend Lot 、 30 Cancel、90 Failed
datestringTransaction Date
seq_nostringOrder Serial Number
branch_nostringBranch Number
accountstringAccount
order_nostringOrder Number
asset_typeintAsset Type : 1 Future 、2 Option
marketstringMarket Type : TAIMEX Future、Option
market_typeFutOptMarketTypeTrading Session Type : FutureOptionFutureNight After-Hour Future、 OptionNight After-Hour Option
unitintUnit
currencystringTrading Currency
symbolstringSymbol
expiry_datestringExpiry Date
strike_pricefloatStrike Price
call_putCallPutCall / Put : CallPut
buy_sellBSActionBuy/Sell Type : BuySell
symbol_leg2stringSpread Symbol
expiry_date_leg2stringExpiry Date - Spread Order
strike_price_leg2floatStrike Price - Spread Order
call_put_leg2CallPutCall / Put : CallPut
buy_sell_leg2BSActionBuy/Sell Type - Spread Order: BuySell
price_typeFutOptPriceTypeOriginal Order Price Type : LimitMarketRangeMarket Market with Protection Orders 、 Reference
pricefloatOrder Price
lotsintOriginal Order Lot
time_in_forceTimeInForceTime In Force : ROD FOKIOC
order_typeFutOptOrderTypeOrder Type : NewCloseAutoFdayTrade DayTrade
is_pre_orderboolReservation Order Flag
statusintOrder Status : 0 Reservation 、 4 In queue 、 8 Processing by system backend 、 9 TimeOut 、 10 Active Order 、 30 Cancel Order 、 50 Fully Filled 、 90 Order Failed
after_price_typeFutOptPriceTypeValid Order Price Type : Limit MarketRangeMarket Market with Protection Orders 、 Reference
after_pricefloatValid Order Price
after_lotintValid Order Lot
filled_lotintFilled Lot
filled_moneyfloatFilled Value
before_lotintBefore the Lot Modification
before_pricefloatBefore the Price Modification
user_defstringCustom Fields
last_timestringLast Modification Time
detailslistOrder Process
>> function_typeintFunction Type : 10 Execute New、 15 Amend Price 、 20 Amend Quantity 、 30 Cancel 、50 Fully Filled、90 Failed
>> modified_timestringOrder Modified Time
>> before_lotintOriginal Order Lot
>> after_lotintValid Order Lot
>> before_pricefloatOriginal Order Price
>> after_pricefloatValid Order Price
>> filled_moneyfloatFilled Value
>> error_messagestringError Message
error_messagestringError Message

Request Example

sdk.futopt.order_history(accounts,"20240410","20240411")

回傳範例

Result {
is_success: True,
message: None,
data : [
FutOptOrderResult{
function_type: None, # Function Type (int): `0` New, `15` Amend Price, `20` Amend Lot, `30` Cancel
date: "2024/04/11", # Transaction Date (string)
seq_no: "00230177314", # Order Serial Number (string)
branch_no: "15000", # Branch Number (string)
account: "9974825", # Account (string)
order_no: "C0020", # Order Number (string)
asset_type: 2, # Asset Type (int): `1` Future, `2` Option
market: "TAIMEX", # Market Type (string)
market_type: Option, # Trading Session Type (FutOptMarketType): `Future`, `Option`, `FutureNight` After-Hour Future, `OptionNight` After-Hour Option
unit: None, # Unit (int)
currency: None, # Trading Currency (string)
symbol: "TXO", # Symbol (string)
expiry_date: "202404", # Expiry Date (string)
strike_price: 18600, # Strike Price (float)
call_put: Call, # Call / Put (CallPut): `Call`, `Put`
buy_sell: Buy, # Buy/Sell Type (BSAction): `Buy`, `Sell`
symbol_leg2: None, # Spread Symbol (string)
expiry_date_leg2: None, # Expiry Date - Spread Order (string)
strike_price_leg2: None, # Strike Price - Spread Order (float)
call_put_leg2: None, # Call / Put - Spread Order (CallPut)
buy_sell_leg2: None, # Buy/Sell Type - Spread Order (BSAction)
price_type: Limit, # Original Order Price Type (FutOptPriceType): `Limit`, `Market`, `RangeMarket` Market with Protection Orders, `Reference`
price: 2100, # Order Price (float)
lot: 1, # Original Order Lot (int)
time_in_force: ROD, # Time In Force (TimeInForce): `ROD`, `FOK`, `IOC`
order_type: New, # Order Type (FutOptOrderType): `New`, `Close`, `Auto`, `FdayTrade` DayTrade
is_pre_order: false, # Reservation Order Flag (bool)
status: 50, # Order Status (int): `0` Reservation, `4` InQueue, `9` TimeOut, `10` New Order, `30` Cancel Order, `50` Fully Filled, `90` Order Failed
after_price_type: None, # Valid Order Price Type (FutOptPriceType): `Limit`, `Market`, `RangeMarket` Market with Protection Orders, `Reference`
after_price: 2100, # Valid Order Price (float)
after_lot: 1, # Valid Order Lot (int)
filled_lot: 1, # Filled Lot (int)
filled_money: 2100, # Filled Value (float)
before_lot: None, # Before the Lot Modification (int)
before_price: None, # Before the Price Modification (float)
user_def: None, # Custom Fields (string)
last_time: "10:41:46.760", # Last Modification Time (string)
details:[
OrderDetail{
function_type: 10, # Function Type (int)
modified_time: "10:41:46.760", # Order Modified Time (string)
before_lot: 0, # Original Order Lot (int)
after_lot: 1, # Valid Order Lot (int)
before_price: 2100, # Original Order Price (float)
after_price: 2100 # Valid Order Price (float)
}
]
error_message: None # Error Message (string)
}
... #More Result Reponse
]
}