圈款（預繳）查詢

query_reserves

版本資訊

v2.2.9 起新增功能

使用限制

• reserved_amount 為扣除預收手續費後的可動用預收金額，費率見 圈存與匯撥。
• returned_amount 於交易日下午結帳後更新，盤中查詢不會反映當日的返還金額。

輸入參數

參數	類別	說明
account	Account	帳號

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	ReserveCashSummary	回傳整戶預繳彙總
message	string	當 is_success = false 回傳錯誤訊息

預繳彙總 ReserveCashSummary 欄位

Return type : Object

參數	類別	說明
branch_no	string	分公司代號
account	string	帳號
currency	string	幣別 : TWD 新台幣
reserved_amount	int	預收金額（元）
returned_amount	int	返還金額（元）
ordered_amount	int	已委託金額（元）

請求範例

sdk.stock.query_reserves(account)

回傳範例

Result {
    is_success: True,
    message: None,
    data : ReserveCashSummary {
        branch_no: "20207",          # 分公司代號 (string)
        account: "9801163",          # 帳號 (string)
        currency: "TWD",             # 幣別 (string)
        reserved_amount: 9960200,    # 預收金額 (int)
        returned_amount: 0,          # 返還金額 (int)
        ordered_amount: 0,           # 已委託金額 (int)
}}