Skip to main content

股票匯撥申請

transfer_stock

版本資訊

v2.2.9 起新增功能

使用限制
  • 申請服務時段為交易日 08:00 ～ 14:30，時段外送出會被後端拒絕。
  • 送出後無法透過 API 取消。
  • 結果以本方法回傳的 status（10 成功、90 失敗）為準；匯撥紀錄查詢不會立即反映該筆申請。
  • 完整作業特性見圈存與匯撥。
撥入分公司代號（target_branch_no）怎麼查？

請填入撥入證券分公司的集保代號，不是銀行分行代碼或自行編列的內部代號。

  1. 先到 券商總覽查詢 確認券商資訊。
  2. 撥入富邦證券分公司時，再以 富邦分公司代號明細 確認實際分公司代號。
  3. 將查得的代號依原格式填入（例如 "960C"），包含英數字母。

輸入參數​

參數類別說明
accountAccount帳號（撥出方）
target_branch_nostring撥入證券分公司集保代號
target_accountstring撥入方帳號
stock_nostring股票代號
quantityint匯撥股數，單位為股，須大於 0
marketMarket (optional)市場別 : Taiex 上市 、 Taisdaq 上櫃 、 Taiemg 興櫃。未帶入時由 SDK 自動判別

Result 回傳​

參數類別說明
is_successbool是否成功
dataTransferRecord回傳匯撥申請資訊
messagestring當is_success = false 回傳錯誤訊息

匯撥紀錄 TransferRecord 欄位​

Return type : Object

參數類別說明
seq_nostring委託單流水序號
datestring申請日期
timestring申請時間
stock_nostring股票代號
marketMarket市場別 : Taiex 上市 、 Taisdaq 上櫃 、 Taiemg 興櫃
quantityint匯撥股數（股）
target_branch_nostring撥入證券分公司集保代號
target_accountstring撥入方帳號
statusint狀態碼 : 10 成功 、 90 失敗

請求範例​

sdk.stock.transfer_stock(account, "960C", "7654321", "006205", 2000)

回傳範例​

Result {
    is_success: True,
    message: None,
    data : TransferRecord {
        date: "2026/07/28",          # 申請日期 (string)
        time: "10:53:48.340",        # 申請時間 (string)
        seq_no: "418181",            # 委託單流水序號 (string)
        stock_no: "006205",            # 股票代號 (string)
        market: Taiex,               # 市場別 (Market)
        quantity: 2000,              # 匯撥股數 (int)
        target_branch_no: "960C",    # 撥入證券分公司集保代號 (string)
        target_account: "7654321",   # 撥入方帳號 (string)
        status: 10,                  # 狀態碼 (int)
}}