Skip to main content

資券配額查詢

margin_quota

輸入參數

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

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(target_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;
}

回傳範例

{
isSuccess = True,
message = ,
data = MarginShortQuota{
stockNo = 2330,
date = 2024/01/24,
shortsellOrigQuota = 894,
shortsellTradableQuota = 894,
marginOrigQuota = ,
marginTradableQuota = ,
marginRatio = 60,
shortRatio = 90
}
}