Transferable Inventory Query

QueryTransferInventory

Version

Available in v2.2.9 and later.

Parameters

Field	Type	Description
account	Account	Account

Result

Field	Type	Description
IsSuccess	bool	Whether the request succeeded
Data	*[]TransferInventoryItem	List of transferable inventory; an empty list when no records exist
Message	*string	Error message when IsSuccess is false

Transferable inventory: TransferInventoryItem fields

Return type : Object

Field	Type	Description
StockNo	string	Stock symbol
Market	Market	Market: MarketTaiex TWSE, MarketTaisdaq TPEx, MarketTaiemg Emerging
AvailableShare	int64	Transferable shares

Request example

package main

import (
    "fmt"
    "fubon"
)

func main() {
    // Initialize the SDK and log in
    sdk := fubon.NewFubonSDK()

    // ... Login and connection initialization steps ...

    // Transferable Inventory Query
    inventoryResult, err := sdk.Stock.QueryTransferInventory(account)

    // Handle transport or SDK errors
    if err != nil {
        fmt.Printf("❌ Query Transfer Inventory Error: %v (Type: %T)\n", err, err)
        return
    }

    // Check the API result
    if !inventoryResult.IsSuccess {
        message := "No message"
        if inventoryResult.Message != nil {
            message = *inventoryResult.Message
        }
        fmt.Printf("Query transfer inventory failed. Message: %s\n", message)
        return
    }

    // Print the transferable inventory
    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.")
    }
}

Response example

// QueryTransferInventory response structure
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},
    },
}