Skip to main content

可匯撥庫存查詢

QueryTransferInventory

版本資訊

v2.2.9 起新增功能

輸入參數​

參數類別說明
accountAccount帳號

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*[]TransferInventoryItem回傳可匯撥庫存列表，查無資料時為空列表
Message*string當 IsSuccess = false 回傳錯誤訊息

可匯撥庫存 TransferInventoryItem 欄位​

Return type : Object

參數類別說明
StockNostring股票代號
MarketMarket市場別 : MarketTaiex 上市 、 MarketTaisdaq 上櫃 、 MarketTaiemg 興櫃
AvailableShareint64可匯撥股數（股）

請求範例​

package main

import (
    "fmt"
    "fubon"
)

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

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

    // 可匯撥庫存查詢
    inventoryResult, err := sdk.Stock.QueryTransferInventory(account)

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

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

    // 輸出可匯撥庫存列表
    if inventoryResult.Data != nil && len(*inventoryResult.Data) > 0 {
        fmt.Printf("✅ Found %d transferable stocks\n", len(*inventoryResult.Data))

        for i, item := range *inventoryResult.Data {
            fmt.Printf("\n--- Item %d ---\n", i+1)
            fmt.Printf("StockNo: %s\n", item.StockNo)
            fmt.Printf("Market: %v\n", item.Market)
            fmt.Printf("AvailableShare: %d\n", item.AvailableShare)
        }
    } else {
        fmt.Println("Query transfer inventory success but no data returned.")
    }
}

回傳範例​

// QueryTransferInventory 回傳結構
Result{
    IsSuccess: true,
    Message:   nil,
    Data: &[]TransferInventoryItem{
        {StockNo: "2331", Market: MarketTaiex, AvailableShare: 5000},
        {StockNo: "2883", Market: MarketTaiex, AvailableShare: 1910},
        {StockNo: "6279", Market: MarketTaisdaq, AvailableShare: 2000},
        {StockNo: "6806", Market: MarketTaiex, AvailableShare: 2000},
    },
}