圈券申請

reserve_stock

版本資訊

v2.2.9 起新增功能

使用限制

• 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
• 送出後無法透過 API 取消。
• 完整作業特性見圈存與匯撥。

輸入參數

參數	類別	說明
account	Account	帳號
stock_no	string	股票代號
quantity	int	圈存股數，單位為股（1 張＝1,000 股），須大於 0

Result 回傳

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

圈券紀錄 ReserveStockRecord 欄位

Return type : Object

參數	類別	說明
seq_no	string	委託單流水序號
stock_no	string	股票代號
reserved_share	int	圈存股數（股）

請求範例

sdk.stock.reserve_stock(account, "2330", 1000)

回傳範例

Result {
    is_success: True,
    message: None,
    data : ReserveStockRecord {
        stock_no: "2330",       # 股票代號 (string)
        market: Taiex,          # 市場別 (Market)
        reserved_share: 1000,   # 圈存股數 (int)
        seq_no: "417106",       # 委託單流水序號 (string)
}}