圈款（預繳）申請

reserve_cash

版本資訊

v2.2.9 起新增功能

使用限制

• 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
• 送出後無法透過 API 取消。
• 結果以本方法回傳的 status（10 成功、90 失敗）為準。
• 完整作業特性見圈存與匯撥。

輸入參數

參數	類別	說明
account	Account	帳號
amount	int	預繳金額（新台幣元），須大於 0

Result 回傳

參數	類別	說明
is_success	bool	是否成功
data	ReserveCashRecord	回傳圈款申請資訊
message	string	當is_success = false 回傳錯誤訊息

圈款紀錄 ReserveCashRecord 欄位

Return type : Object

參數	類別	說明
seq_no	string	委託單流水序號
date	string	申請日期
time	string	申請時間
branch_no	string	分公司代號
account	string	帳號
currency	string	幣別 : TWD 新台幣
amount	int	預繳金額（元）
status	int	狀態碼 : 10 成功 、 90 失敗

請求範例

sdk.stock.reserve_cash(account, 10000)

回傳範例

Result {
    is_success: True,
    message: None,
    data : ReserveCashRecord {
        date: "2026/07/28",          # 申請日期 (string)
        time: "10:53:23.000",        # 申請時間 (string)
        seq_no: "118036",            # 委託單流水序號 (string)
        branch_no: "20207",          # 分公司代號 (string)
        account: "9801163",          # 帳號 (string)
        currency: "TWD",             # 幣別 (string)
        amount: 10000,              # 預繳金額 (int)
        status: 10,                  # 狀態碼 (int)
}}