PlaceOrder

place_order

Request Parameter

Parameter	Type	Meaning
account	Account	Account
order_object	OrderObject	Order Object
unblock	bool (optional) (default = False)	unblock

Result Response

Parameter	Type	Meaning
is_success	bool	Interface result
data	OrderResult	OrderResult is returned
message	string	is_success = False error description is returned

OrderResult Parameter

Return type : Object

Parameter	Type	Meaning
function_type	int	Function Type : 0 New Order 、 10 New Order Executed 、 15 Change Price 、 20 Change Quantity 、 30 Cancel 、 90 Failed
date	string	Transaction Date
seq_no	string	Order Serial Number
branch_no	string	Branch Number
account	string	Account
order_no	string	Order Number
asset_type	int	Asset Type : 0 Stock
market	string	Market Type : TAIEX Listed 、 TAISDAQ OTC 、 TAIEMG EMG
market_type	MarketType	Trading Session Type : Common 、 Fixing 、 IntradayOdd 、 Odd 、 Emg 、 EmgOdd
stock_no	string	Symbol
buy_sell	BSAction	Buy/Sell Type : Buy 、 Sell
price_type	PriceType	Original Order Price Type : Limit 、 LimitUp 、 LimitDown 、 Market 、 Reference
price	float	Order Price
quantity	int	Original Order Quantity
time_in_force	TimeInForce	Time In Force : ROD FOK 、 IOC
order_type	OrderType	Order Type : Stock 、 Margin 、 Short 、 DayTrade 、 SBL
is_pre_order	bool	Reservation Order Flag
status	int	Order Status, for details please refer to STATUS
after_price_type	PriceType	Valid Order Price Type : Limit 、 LimitUp 、 LimitDown 、 Market 、 Reference
after_price	float	Valid Order Price
unit	int	Trading Unit
after_qty	int	Valid Order Quantity (filled quantity included)
filled_qty	int	Filled Quantity
filled_money	int	Filled Value
before_qty	int	Before the Quantity Modification
before_price	float	Before the Price Modification
user_def	string	Custom Fields
last_time	string	Last Modification Time
details	list	Order Process (Return value when query order_result_detail or order_history )
error_message	string	Error Message

Request Example

order = Order(
    buy_sell = BSAction.Buy,
    symbol = "2881",
    price = "66",
    quantity =  1000,
    market_type = MarketType.Common,
    price_type = PriceType.Limit,
    time_in_force = TimeInForce.ROD,
    order_type = OrderType.Stock,
    user_def = "From_Py" # optional field
)


sdk.stock.place_order(account, order)

Response Example

Result {
    is_success: True,
    message: None,
    data : 
        OrderResult{
            function_type: 0,                # Function Type (int)
            date: "2023/10/12",              # Trading Date (string)
            seq_no: "00000000007",           # Order serial number (string)
            branch_no: "6460",               # Branch number (string)
            account: "26",                   # Account (string)
            order_no: "bA676",               # Order number (string)
            asset_type: 0,                   # Asset type (int)
            market: "TAIEX",                 # Market Category (string)
            market_type: Common,             # Trading session type (MarketType)
            stock_no: "2881",                # Symbol (string)
            buy_sell: Buy,                   # Buy / Sell Type (BSAction)
            price_type: Limit,               # Order price type (int)
            price: 66,                       # Order Price (float)
            quantity: 1000,                  # Order quantity (int)
            time_in_force: 0,                # Time in force (int)
            order_type: Stock,               # Order Type (OrderType)
            is_pre_order: false,             # Reservation flag (bool)
            status: 10,                      # Order Status (int)
            after_price_type: Limit,         # Valid order price type (PriceType)
            after_price: 66,                 # Valid order price (float)
            unit: 1000,                      # Share Unit (int)
            after_qty: 2000,                 # Valid order quantity (int)
            filled_qty: 0,                   # Filled quantity (int)
            filled_money: 0,                 # Filled Value (int)
            before_qty: 0,                   # Before the quantity modification (int)
            before_price: 8.9,               # Before the price modification (float)
            user_def: "From_Py",         # Custom fields (string)
            last_time: "14:05:12.085",        # Last modification time (string)
            details: None,                    # Order Process (list)
            error_message: None              # Error Message (string)
        }
}