Skip to main content

維持率查詢

Maintenance

輸入參數​

參數類別說明
accountAccount帳號

Result 回傳​

參數類別說明
IsSuccessbool是否成功
Data*MaintenanceData回傳維持率資訊
Message*string當 IsSuccess = false 回傳錯誤訊息

維持率 MaintenanceData 欄位​

參數類別說明
Date*string查詢日
BranchNo*string分公司代號
Account*string帳號
MaintenanceSummary*MaintenanceSummary整戶維持率彙總
>> MarginValue*int64整戶融資市值
>> ShortsellValue*int64整戶融券市值
>> ShortsellMargin*int64整戶融券保證金額
>> Collateral*int64擔保品
>> MarginLoanAmt*int64整戶融資金額
>> MaintenanceRatio*string整戶維持率 (%)
MaintenanceDetail*[]MaintenanceDetail個股維持率明細
>> StockNo*string股票代碼
>> OrderNo*string委託書號
>> OrderTypeOrderType委託單類型 : OrderTypeStock 現股 、 OrderTypeMargin 融資 、 OrderTypeShort 融券 、 OrderTypeDayTrade 現股當沖 、OrderTypeSbl 借券
>> Quantity*int64持有股數
>> Price*string計算價
>> CostPrice*string成本價
>> ShortsellMargin*int64融券保證金
>> Collateral*int64擔保品
>> MarginLoanAmt*int64融資金
>> MaintenanceRatio*string維持率 (%)
>> CollateralInterest*string擔保品利息
>> MarginInterest*string融資金利息
>> ShortsellInterest*string融券保證金利息

請求範例​

package main

import (
    "fmt"
    "fubon"
)

func main() {
    sdk := fubon.NewSDK()
    // ... 登入、連線等初始化步驟 ...
    
    // 查詢維持率
    maintenance, err := sdk.Accounting.Maintenance(account)
    if err != nil {
        fmt.Printf("❌ Maintenance Format/Parser Error: %v\n", err)
        return
    }
    
    if maintenance.IsSuccess && maintenance.Data != nil {
        fmt.Println("✅ Maintenance Data:")
        
        // 整戶維持率
        if maintenance.Data.MaintenanceSummary != nil {
            summary := maintenance.Data.MaintenanceSummary
            fmt.Printf("\n整戶維持率: %s%%\n", *summary.MaintenanceRatio)
            fmt.Printf("融資市值: %d\n", *summary.MarginValue)
            fmt.Printf("融資金額: %d\n", *summary.MarginLoanAmt)
            fmt.Printf("擔保品: %d\n", *summary.Collateral)
        }
        
        // 個股明細
        if maintenance.Data.MaintenanceDetail != nil {
            fmt.Printf("\n個股明細 (%d 筆):\n", len(*maintenance.Data.MaintenanceDetail))
            for i, detail := range *maintenance.Data.MaintenanceDetail {
                fmt.Printf("\n[%d] %s\n", i+1, *detail.StockNo)
                fmt.Printf("  持有: %d 股\n", *detail.Quantity)
                fmt.Printf("  成本價: %s, 計算價: %s\n", *detail.CostPrice, *detail.Price)
                fmt.Printf("  維持率: %s%%\n", *detail.MaintenanceRatio)
            }
        }
    }
}

回傳範例​

Result{
    IsSuccess: true,
    Message:   nil,
    Data: &MaintenanceData{
        Date:     "2024/02/27",
        BranchNo: "6460",
        Account:  "26",
        MaintenanceSummary: &MaintenanceSummary{
            MarginValue:      3135000,
            ShortsellValue:   0,
            ShortsellMargin:  0,
            Collateral:       0,
            MarginLoanAmt:    1494000,
            MaintenanceRatio: "209.83",
        },
        MaintenanceDetail: &[]MaintenanceDetail{
            {
                StockNo:            "2603",
                OrderNo:            "x4580",
                OrderType:          OrderTypeStock,
                Quantity:           10000,
                Price:              "152.5",
                CostPrice:          "119",
                ShortsellMargin:    0,
                Collateral:         0,
                MarginLoanAmt:      0,
                MaintenanceRatio:   "213.58",
                CollateralInterest: "0",
                MarginInterest:     "20818",
                ShortsellInterest:  "0",
            },
        },
    },
}