Place Order
PlaceOrder
Input Parameters
| Parameter | Type | Description |
|---|---|---|
| account | Account | Account |
| order | Order | Order Content |
| unblock | *bool (optional) (default = false) | Whether to use non-blocking |
Result Return
| Parameter | Type | Description |
|---|---|---|
| IsSuccess | bool | Whether successful |
| Data | *OrderResult | Returns order information |
| Message | *string | Returns error message when IsSuccess = false |
Order Information OrderResult Fields
Return type : Object
| Parameter | Type | Description |
|---|---|---|
| FunctionType | *int64 | Function Type: 0 New Order, 10 Execute New Order, 15 Change Price, 20 Change Qty, 30 Cancel Order, 90 Fail |
| Date | *string | Transaction Date |
| SeqNo | *string | Order Sequence Number |
| BranchNo | *string | Branch Code |
| Account | *string | Account |
| OrderNo | *string | Order Number |
| AssetType | *int64 | Asset Type: 0 Securities |
| Market | *string | Market: TAIEX Listed Stocks, TAISDAQ OTC Stocks, TAIEMG Emerging Stocks |
| MarketType | MarketType | Market Type Category: MarketTypeCommon Regular Stock, MarketTypeFixing Fixing, MarketTypeIntradayOdd Intraday Odd Lot, MarketTypeOdd Post-market Odd Lot, MarketTypeEmg Emerging, MarketTypeEmgOdd Emerging Odd Lot |
| StockNo | *string | Stock Symbol |
| BuySell | *BsAction | Buy/Sell Action: BsActionBuy Buy, BsActionSell Sell |
| PriceType | *PriceType | Effective Price Type: PriceTypeLimit Limit, PriceTypeLimitUp Limit Up, PriceTypeLimitDown Limit Down, PriceTypeMarket Market, PriceTypeReference Reference |
| Price | *string | Price |
| Quantity | *int64 | Original Order Quantity |
| TimeInForce | *TimeInForce | Order Condition: TimeInForceRod ROD, TimeInForceFok FOK, TimeInForceIoc IOC |
| OrderType | *OrderType | Order Type: OrderTypeStock Common, OrderTypeMargin Margin, OrderTypeShort Short Sell, OrderTypeDayTrade Day Trade, OrderTypeSbl SBL |
| IsPreOrder | *bool | Is Pre-order |
| Status | *int64 | Order Status: 0 Pre-order, 4 Sending to Backend, 9 Connection Timeout, 10 Order Success, 30 Cancelled Unfilled, 40 Partial Fill/Rest Cancelled, 50 Fully Filled, 90 Fail |
| AfterPriceType | *PriceType | Effective Price Type: PriceTypeLimit Limit, PriceTypeLimitUp Limit Up, PriceTypeLimitDown Limit Down, PriceTypeMarket Market, PriceTypeReference Reference |
| AfterPrice | *string | Effective Order Price |
| Unit | *int64 | Unit |
| AfterQty | *int64 | Effective Order Quantity (including filled part) |
| FilledQty | *int64 | Filled Quantity |
| FilledMoney | *int64 | Filled Amount |
| BeforeQty | *int64 | Effective Qty Before Change |
| BeforePrice | *string | Effective Price Before Change |
| UserDef | *string | User Defined Field |
| LastTime | *string | Last Modified Time |
| Details | *string | Order History (Value exists only when querying OrderResultDetail or OrderHistory) |
| ErrorMessage | *string | Error Message |
Request Example
package main
import (
"fmt"
"fubon"
)
func main() {
// Initialize SDK
sdk := fubon.NewSDK()
orderPrice := "66.1"
order := fubon.Order{
BuySell: fubon.BsActionBuy,
Symbol: "2881",
Price: &orderPrice,
Quantity: 1000,
MarketType: fubon.MarketTypeCommon,
PriceType: fubon.PriceTypeLimit,
TimeInForce: fubon.TimeInForceRod,
OrderType: fubon.OrderTypeStock,
}
unblock := false
result, err := sdk.Stock.PlaceOrder(account, order, &unblock)
if err != nil {
fmt.Printf("❌ Place Order Format/Parse Error: %v (Type: %T)\n", err, err)
} else {
fmt.Printf("✓ Order Placed", *result.IsSuccess)
}
}
Response Example
// OrderResult Structure
Result{
IsSuccess: true,
Message: nil,
Data: &OrderResult{
FunctionType: 0, // Function Type
Date: "2023/10/13", // Transaction Date
SeqNo: "00000000007", // Order Sequence Number
BranchNo: "6460", // Branch Code
Account: "26", // Account
OrderNo: "bA619", // Order Number
AssetType: 0, // Asset Type
Market: "TAIEX", // Market Type
MarketType: MarketTypeCommon, // Market Type Category
StockNo: "2888", // Stock Symbol
BuySell: BsActionBuy, // Buy/Sell Action
PriceType: PriceTypeLimit, // Original Price Type
Price: "9.1", // Price
Quantity: 3000, // Original Order Quantity
TimeInForce: TimeInForceRod, // Order Condition
OrderType: OrderTypeStock, // Order Type
IsPreOrder: false, // Is Pre-order
Status: 10, // Order Status
AfterPriceType: PriceTypeLimit, // Effective Price Type
AfterPrice: "9.1", // Effective Order Price
Unit: 1000, // Unit
AfterQty: 3000, // Effective Order Quantity
FilledQty: 0, // Filled Quantity
FilledMoney: 0, // Filled Amount
BeforeQty: 0, // Effective Qty Before Change
BeforePrice: "9.1", // Effective Price Before Change
UserDef: "", // User Defined Field
LastTime: "12:10:12.546", // Last Modified Time
Details: nil, // Order History
ErrorMessage: "", // Error Message
},
}