Skip to main content

資券配額查詢

margin_quota

輸入參數​

參數類別說明
accountAccount帳號
stock_nostring股票代碼

Result 回傳​

參數類別說明
is_successbool是否成功
dataMarginShortQuota回傳配額資訊
messagestring當 is_success = False 回傳錯誤訊息

配額資訊 MarginShortQuota 欄位​

Return type : Object

參數類別說明
stock_nostring股票代號
datestring日期
shortsell_orig_quotaint原始融券餘額
shortsell_tradable_quotaint可用融券餘額
margin_orig_quotaint原始融資餘額
margin_tradable_quotaint可用融資餘額
margin_ratioint融資成數
short_ratioint融券成數
info

額度相關說明 : 融資成數回傳空值表示停資;融券成數回傳空值表示停券,
回傳的額度說明 : 0 - 無額度 / 大於 0 - 有額度 / 空值 - 無限制 / 餘額皆為 0 - 停資 or 停券

請求範例​

auto quota_response = sdk->stock->margin_quota(account, "2330");

if (!quota_response.is_success) {
std::cerr << "Quota query failed: " << (quota_response.message ? *quota_response.message : "No message") << std::endl;
return 1;
}

// 搭配自定義 .cpp & hpp Output
if (quota_response.data.has_value()) {
const auto& quota = quota_response.data.value();
std::cout << quota << std::endl;
} else {
std::cout << "No quota data available." << std::endl;
}

回傳範例​

{
is_success = True,
message = ,
data = MarginShortQuota{
stock_no = 2330,
date = 2024/01/24,
shortsell_orig_quota = 894,
shortsell_tradable_quota = 894,
margin_orig_quota = ,
margin_tradable_quota = ,
margin_ratio = 60,
short_ratio = 90
}
}