Query Order History

OrderHistory

Input Parameters

Parameter	Type	Description
account	Account	Account
startDate	string	Query Start Date (Format: YYYYMMDD)
endDate	*string (Null default same as Start Date)	Query End Date (Format: YYYYMMDD)

info

Maximum query range setting is 30 days per query.

Result Return

Parameter	Type	Description
IsSuccess	bool	Whether successful
Data	*[]OrderResult	Returns historical order list (including history details)
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
ErrorMessage	*string	Error Message
Details	*[]OrderDetail	Order History
>> FunctionType	*int64	Function Type: 0 New Order, 10 Execute New Order, 15 Change Price, 20 Change Qty, 30 Cancel Order, 50 Fully Filled, 90 Fail
>> ModifiedTime	*string	Modified Time
>> BeforeQty	*int64	Original Order Quantity
>> AfterQty	*int64	Effective Order Quantity (including filled part)
>> BeforePrice	*string	Original Order Price
>> AfterPrice	*string	Effective Order Price
>> FilledMoney	*string	Filled Amount
>> Status	*int64	Order Status
>> 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 ...
    
    // Query Order History
    startDate := "20250502"
    endDate := "20250502"
    
    orderHis, err := sdk.Stock.OrderHistory(account, startDate, &endDate)
    
    // Error Handling
    if err != nil {
        fmt.Printf("❌ Order History Format/Parse Error:: %v (Type: %T)\n", err, err)
        return
    }
    
    // Check Success
    if !orderHis.IsSuccess {
        message := "No message"
        if orderHis.Message != nil {
            message = *orderHis.Message
        }
        fmt.Printf("Order history failed. Message: %s\n", message)
        return
    }
    
    // Output Order History List
    if orderHis.Data != nil && len(*orderHis.Data) > 0 {
        fmt.Printf("✅ Found %d historical orders\n", len(*orderHis.Data))
        
        for i, result := range *orderHis.Data {
            fmt.Printf("\n=== Historical Order %d ===\n", i+1)
            fmt.Printf("Date: %s\n", *result.Date)
            fmt.Printf("OrderNo: %s\n", *result.OrderNo)
            fmt.Printf("StockNo: %s\n", *result.StockNo)
            fmt.Printf("BuySell: %v\n", *result.BuySell)
            fmt.Printf("Price: %s\n", *result.Price)
            fmt.Printf("Quantity: %d\n", *result.Quantity)
            fmt.Printf("Status: %d\n", *result.Status)
            fmt.Printf("FilledQty: %d\n", *result.FilledQty)
            
            // Display Order History Details
            if result.Details != nil && len(*result.Details) > 0 {
                fmt.Printf("\n  Order Details (%d records):\n", len(*result.Details))
                for j, detail := range *result.Details {
                    fmt.Printf("  [%d] FunctionType: %d, Time: %s\n", 
                        j+1, *detail.FunctionType, *detail.ModifiedTime)
                    fmt.Printf("      Qty: %d -> %d, Price: %s -> %s\n",
                        *detail.BeforeQty, *detail.AfterQty, 
                        *detail.BeforePrice, *detail.AfterPrice)
                }
            }
        }
    } else {
        fmt.Println("No order history data.")
    }
}

Response Example

// OrderHistory Return Structure
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &[]OrderResult{
        {
            FunctionType:   nil,                  // Function Type
            Date:           "2025/05/02",         // Transaction Date
            SeqNo:          "00000000001",        // Order Sequence Number
            BranchNo:       "6460",               // Branch Code
            Account:        "26",                 // Account
            OrderNo:        "bA598",              // Order Number
            AssetType:      0,                    // Asset Type
            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:     false,                // Is Pre-order
            Status:         10,                   // Order Status
            AfterPriceType: nil,                  // Effective Price Type
            AfterPrice:     "9",                  // Effective Price
            Unit:           1000,                 // Unit
            AfterQty:       1000,                 // Effective Order Quantity
            FilledQty:      0,                    // Filled Quantity
            FilledMoney:    0,                    // Filled Amount
            BeforeQty:      nil,                  // Effective Qty Before Change
            BeforePrice:    nil,                  // Effective Price Before Change
            UserDef:        "",                   // User Defined Field
            LastTime:       "14:19:41.879",       // Last Modified Time
            ErrorMessage:   "",                   // Error Message
            Details: &[]OrderDetail{             // Order History
                {
                    FunctionType: 10,
                    ModifiedTime: "14:19:41.879",
                    BeforeQty:    0,
                    AfterQty:     1000,
                    BeforePrice:  "9.0",
                    AfterPrice:   "9.0",
                    Status:       10,
                    ErrorMessage: "",
                },
            },
        },
        // ... more historical orders
    },
}