Skip to main content

建立委託單

PlaceOrder

輸入參數​

參數類別說明
accountAccount帳號
orderOrder委託內容
unblock*bool (optional) (default = false)是否採用非阻塞

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*OrderResult回傳委託資訊
Message*string當 IsSuccess = false 回傳錯誤訊息

委託資訊 OrderResult 欄位​

Return type : Object

參數類別說明
FunctionType*int64功能別 : 0 新單 、 10 新單執行 、 15 改價 、 20 改量 、 30 刪單 、 90 失敗
Date*string交易日期
SeqNo*string委託單流水序號
BranchNo*string分公司代號
Account*string帳號
OrderNo*string委託書號
AssetType*int64資產類別 : 0 證券
Market*string市場類型 : TAIEX 上市股票 、 TAISDAQ 上櫃股票 、 TAIEMG 興櫃股票
MarketTypeMarketType盤別種類 : MarketTypeCommon 整股 、 MarketTypeFixing 定盤 、 MarketTypeIntradayOdd 盤中零股 、 MarketTypeOdd 盤後零股 、 MarketTypeEmg 興櫃 、 MarketTypeEmgOdd 興櫃零股
StockNo*string股票代號
BuySell*BsAction買賣別 : BsActionBuy 買 、 BsActionSell 賣
PriceType*PriceType有效委託價格別 : PriceTypeLimit 限價 、 PriceTypeLimitUp 漲停 、 PriceTypeLimitDown 跌停 、 PriceTypeMarket 市價 、 PriceTypeReference 參考價
Price*string價格
Quantity*int64原始委託股數
TimeInForce*TimeInForce委託條件別 : TimeInForceRod ROD 、 TimeInForceFok FOK 、 TimeInForceIoc IOC
OrderType*OrderType委託單類型 : OrderTypeStock 現股 、 OrderTypeMargin 融資 、 OrderTypeShort 融券 、 OrderTypeDayTrade 現股當沖 、 OrderTypeSbl 借券
IsPreOrder*bool是否為預約單
Status*int64委託單狀態 : 0 預約單 、 4 系統將委託送往後台 、 9 連線逾時 、10 委託成功 、 30 未成交刪單成功 、 40 部分成交,剩餘取消 、 50 完全成交 、 90 失敗
AfterPriceType*PriceType有效委託價格別 : PriceTypeLimit 限價 、 PriceTypeLimitUp 漲停 、 PriceTypeLimitDown 跌停 、 PriceTypeMarket 市價 、 PriceTypeReference 參考價
AfterPrice*string有效委託價格
Unit*int64單位數
AfterQty*int64有效委託股數（包含已成交部分）
FilledQty*int64成交股數
FilledMoney*int64成交價金
BeforeQty*int64改單前有效量
BeforePrice*string改單前有效價
UserDef*string自訂欄位
LastTime*string最後異動時間
Details*string委託歷程 (查詢 OrderResultDetail 或 OrderHistory 才有值)
ErrorMessage*string錯誤訊息

請求範例​

package main

import (
    "fmt"
    "fubon"
)

func main() {
    // 初始化 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)
	}
}

回傳範例​

// OrderResult 結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &OrderResult{
        FunctionType:   0,                    // 功能別
        Date:           "2023/10/13",         // 交易日期
        SeqNo:          "00000000007",        // 委託單流水序號
        BranchNo:       "6460",               // 分公司代號
        Account:        "26",                 // 帳號
        OrderNo:        "bA619",              // 委託書號
        AssetType:      0,                    // 資產類型
        Market:         "TAIEX",              // 市場類型
        MarketType:     MarketTypeCommon,     // 盤別種類
        StockNo:        "2888",               // 股票代號
        BuySell:        BsActionBuy,          // 買賣別
        PriceType:      PriceTypeLimit,       // 原始委託價格別
        Price:          "9.1",                // 價格
        Quantity:       3000,                 // 原始委託股數
        TimeInForce:    TimeInForceRod,       // 委託條件別
        OrderType:      OrderTypeStock,       // 委託單類型
        IsPreOrder:     false,                // 是否為預約單
        Status:         10,                   // 委託單狀態
        AfterPriceType: PriceTypeLimit,       // 有效委託價格別
        AfterPrice:     "9.1",                // 有效委託價格
        Unit:           1000,                 // 單位數
        AfterQty:       3000,                 // 有效委託股數
        FilledQty:      0,                    // 成交股數
        FilledMoney:    0,                    // 成交價金
        BeforeQty:      0,                    // 改單前有效量
        BeforePrice:    "9.1",                // 改單前有效價
        UserDef:        "",                   // 自訂欄位
        LastTime:       "12:10:12.546",       // 最後異動時間
        Details:        nil,                  // 委託歷程
        ErrorMessage:   "",                   // 錯誤訊息
    },
}