修改委託價格

ModifyPrice

先使用 MakeModifyPriceObj 建立 ModifyPriceObj 物件

參數	類別	說明
orderResult	OrderResult	預計修改的委託單
price	*string	修改後的價格
priceType	*PriceType	修改後的價格旗標

caution

當 price 欄位有填入值時，priceType 需為 nil ； 當 priceType 欄位有填入值時，price 需為 nil

將回傳的物件放入 ModifyPrice 的方法中

輸入參數

參數	類別	說明
account	Account	帳號
modifyPriceObj	ModifyPriceObj	修改價格的物件
unblock	*bool (optional) (default = false)	是否採用非阻塞

Result 回傳

參數	類別	說明
IsSuccess	bool	是否成功
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 興櫃股票
MarketType	MarketType	盤別種類 : 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()
    
    // ... 登入、連線等初始化步驟 ...
    
    // 先取得欲調整的委託單
    ordResult, err := sdk.Stock.GetOrderResults(account)
    if err != nil {
        fmt.Printf("❌ Get Order Results Format/Parse Error: %v\n", err)
        return
    }
    
    var modifyOrder fubon.OrderResult
    if ordResult.Data != nil && len(*ordResult.Data) > 0 {
        modifyOrder = (*ordResult.Data)[0]
        fmt.Println("Selected order for price modification")
        fmt.Printf("OrderNo: %s, Current Price: %s\n", *modifyOrder.OrderNo, *modifyOrder.Price)
        
        // 建立改價物件
        newPrice := "41.1"
        modifyPriceObj, err := sdk.Stock.MakeModifyPriceObj(modifyOrder, &newPrice, nil)
        if err != nil {
            fmt.Printf("❌ Make Modify Price Format/Parse Error: %v (Type: %T)\n", err, err)
            return
        }
        
        // 執行改價
        unblock := false
        modifyPriceRes, err := sdk.Stock.ModifyPrice(account, modifyPriceObj, &unblock)
        if err != nil {
            fmt.Printf("❌ Modify Price Format/Parse Error: %v (Type: %T)\n", err, err)
            return
        }
        
        // 檢查是否成功
        if !modifyPriceRes.IsSuccess {
            message := "No message"
            if modifyPriceRes.Message != nil {
                message = *modifyPriceRes.Message
            }
            fmt.Printf("Modify Price failed. Message: %s\n", message)
            return
        }
        
        // 輸出改價結果
        if modifyPriceRes.Data != nil {
            fmt.Println("✅ Price modified successfully!")
            fmt.Printf("BeforePrice: %s -> AfterPrice: %s\n", 
                *modifyPriceRes.Data.BeforePrice, *modifyPriceRes.Data.AfterPrice)
        } else {
            fmt.Println("Modify Price succeeded but no data returned.")
        }
    } else {
        fmt.Println("⚠️  No orders found for price modification")
    }
}

回傳範例

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