Skip to main content

圈券查詢

QueryReservedStocks

版本資訊

v2.2.9 起新增功能

輸入參數​

參數類別說明
accountAccount帳號

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*[]ReserveStockItem回傳已圈存股票列表，查無資料時為空列表
Message*string當 IsSuccess = false 回傳錯誤訊息

圈券餘額 ReserveStockItem 欄位​

Return type : Object

參數類別說明
StockNostring股票代號
MarketMarket市場別 : MarketTaiex 上市 、 MarketTaisdaq 上櫃 、 MarketTaiemg 興櫃
ReservedShareint64圈存股數餘額（股）

請求範例​

package main

import (
    "fmt"
    "fubon"
)

func main() {
    // 初始化 SDK 並登入
    sdk := fubon.NewFubonSDK()

    // ... 登入、連線等初始化步驟 ...

    // 圈券查詢
    reservedResult, err := sdk.Stock.QueryReservedStocks(account)

    // 錯誤處理
    if err != nil {
        fmt.Printf("❌ Query Reserved Stocks Error: %v (Type: %T)\n", err, err)
        return
    }

    // 檢查是否成功
    if !reservedResult.IsSuccess {
        message := "No message"
        if reservedResult.Message != nil {
            message = *reservedResult.Message
        }
        fmt.Printf("Query reserved stocks failed. Message: %s\n", message)
        return
    }

    // 輸出圈券餘額列表
    if reservedResult.Data != nil && len(*reservedResult.Data) > 0 {
        fmt.Printf("✅ Found %d reserved stocks\n", len(*reservedResult.Data))

        for i, item := range *reservedResult.Data {
            fmt.Printf("\n--- Stock %d ---\n", i+1)
            fmt.Printf("StockNo: %s\n", item.StockNo)
            fmt.Printf("Market: %v\n", item.Market)
            fmt.Printf("ReservedShare: %d\n", item.ReservedShare)
        }
    } else {
        fmt.Println("Query reserved stocks success but no data returned.")
    }
}

回傳範例​

// QueryReservedStocks 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &[]ReserveStockItem{
        {StockNo: "2330", Market: MarketTaiex, ReservedShare: 5599},
        {StockNo: "1260", Market: MarketTaiemg, ReservedShare: 3000},
    },
}