Place Order

place_order

Input Parameters

Parameter	Type	Meaning
account	Account	Account
order_object	OrderObject	Order Object
unblock	bool (optional) (default = False)	Whether to use non-blocking mode

Result

Parameter	Type	Meaning
is_success	bool	Whether successful
data	OrderResult	OrderResult is returned
message	string	Error message returned when is_success = false

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 = "FromPy" # 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",              # Transaction Date (string)
        seq_no: "00000000007",           # Order sequence number (string)
        branch_no: "6460",               # Branch code (string)
        account: "26",                   # Account (string)
        order_no: "bA676",               # Order Number (string)
        asset_type: 0,                   # Asset type (int)
        market: "TAIEX",                 # Market Type (string)
        market_type: Common,             # Trading session type (MarketType)
        stock_no: "2881",                # Symbol (string)
        buy_sell: Buy,                   # Buy/sell side (BSAction)
        price_type: Limit,               # Original order price type (PriceType)
        price: 66,                       # Price (float)
        quantity: 1000,                  # Original order quantity (int)
        time_in_force: ROD,              # Time in force (TimeInForce)
        order_type: Stock,               # Order Type (OrderType)
        is_pre_order: false,             # Reservation Order 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,                      # Trading unit (int)
        after_qty: 2000,                 # Valid order quantity (int)
        filled_qty: 0,                   # Filled quantity (int)
        filled_money: 0,                 # Filled amount (int)
        before_qty: 0,                   # Valid quantity before modification (int)
        before_price: 0,                 # Valid price before modification (float)
        user_def: "FromPy",         # Custom Fields (string)
        last_time: "14:05:12.085",        # Last Modification Time (string)
        details: None,                        # Order history (list)
        error_message: None              # Error message (string)
}}