Batch Place Order
BatchPlaceOrder
Input Parameters
| Parameter | Type | Description |
|---|---|---|
| account | Account | Account |
| orders | []Order | List of order contents |
Result Return
| Parameter | Type | Description |
|---|---|---|
| IsSuccess | bool | Whether successful |
| Data | *[]OrderResult | Returns order information list |
| 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 and login
sdk := fubon.NewSDK()
// ... Login, connection, and other initialization steps ...
// Prepare Batch Orders
userDef1 := "batch1"
userDef2 := "batch2"
orders := []fubon.Order{
{
BuySell: fubon.BsActionBuy,
Symbol: "2881",
Price: nil, // Use PriceType to specify
Quantity: 2000,
MarketType: fubon.MarketTypeCommon,
PriceType: fubon.PriceTypeLimitDown, // Limit Down
TimeInForce: fubon.TimeInForceRod,
OrderType: fubon.OrderTypeStock,
UserDef: &userDef1,
},
{
BuySell: fubon.BsActionBuy,
Symbol: "2881",
Price: nil,
Quantity: 2000,
MarketType: fubon.MarketTypeCommon,
PriceType: fubon.PriceTypeLimitDown,
TimeInForce: fubon.TimeInForceRod,
OrderType: fubon.OrderTypeStock,
UserDef: &userDef2,
},
}
// Place Batch Order
batResult, err := sdk.Stock.BatchPlaceOrder(account, orders)
// Error Handling
if err != nil {
fmt.Printf("❌ Batch Place Order Format/Parse Error: %v (Type: %T)\n", err, err)
return
}
// Check Success
if !batResult.IsSuccess {
message := "No message"
if batResult.Message != nil {
message = *batResult.Message
}
fmt.Printf("Batch place order failed. Message: %s\n", message)
return
}
// Output Batch Place Order Result
if batResult.Data != nil && len(*batResult.Data) > 0 {
fmt.Printf("✅ Batch placed %d orders successfully!\n", len(*batResult.Data))
for i, result := range *batResult.Data {
fmt.Printf("\n--- Order %d ---\n", i+1)
fmt.Printf("SeqNo: %s\n", *result.SeqNo)
fmt.Printf("StockNo: %s\n", *result.StockNo)
fmt.Printf("Price: %s\n", *result.Price)
fmt.Printf("Quantity: %d\n", *result.Quantity)
fmt.Printf("Status: %d\n", *result.Status)
if result.UserDef != nil {
fmt.Printf("UserDef: %s\n", *result.UserDef)
}
}
} else {
fmt.Println("Batch order succeeded but no data returned.")
}
}
Response Example
// BatchPlaceOrder Return Structure
Result{
IsSuccess: true,
Message: nil,
Data: &[]OrderResult{
{
FunctionType: 0, // Function Type (New Order)
Date: "2023/09/22", // Transaction Date
SeqNo: "00000221431", // Order Sequence Number
BranchNo: "6460", // Branch Code
Account: "26", // Account
OrderNo: "", // Order Number
Market: "TAIEX", // Market Type
MarketType: Common, // Market Type Category
StockNo: "2888", // Stock Symbol
BuySell: Buy, // Buy/Sell Action
PriceType: Limit, // Original Price Type
Price: "8.9", // Price
Quantity: 2000, // Original Order Quantity
TimeInForce: Rod, // Order Condition
OrderType: Stock, // Order Type
IsPreOrder: true, // Is Pre-order
Status: 0, // Order Status (Pre-order)
AfterPriceType: Limit, // Effective Price Type
AfterPrice: "8.9", // Effective Price
Unit: 1000, // Unit
AfterQty: 2000, // 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: nil, // User Defined Field
LastTime: nil, // Last Modified Time
Details: nil, // Order History
ErrorMessage: "", // Error Message
},
{
FunctionType: 0, // Function Type (New Order)
Date: "2023/09/22", // Transaction Date
SeqNo: "00000221432", // Order Sequence Number
BranchNo: "6460", // Branch Code
Account: "26", // Account
OrderNo: "", // Order Number
Market: "TAIEX", // Market Type
MarketType: Common, // Market Type Category
StockNo: "2888", // Stock Symbol
BuySell: Buy, // Buy/Sell Action
PriceType: Limit, // Original Price Type
Price: "8.9", // Price
Quantity: 2000, // Original Order Quantity
TimeInForce: Rod, // Order Condition
OrderType: Stock, // Order Type
IsPreOrder: true, // Is Pre-order
Status: 0, // Order Status
AfterPriceType: Limit, // Effective Price Type
AfterPrice: "8.9", // Effective Price
Unit: 1000, // Unit
AfterQty: 2000, // 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: nil, // User Defined Field
LastTime: nil, // Last Modified Time
Details: nil, // Order History
ErrorMessage: "", // Error Message
},
},
}