Skip to main content

Stock Transfer Application

transfer_stock

Version

Available in v2.2.9 and later.

Usage limits
  • Applications are accepted on trading days from 08:00 to 14:30. Requests outside this window are rejected by the backend.
  • An application cannot be cancelled through the API after it is submitted.
  • Use the status returned by this method as the result (10 success; 90 failure). The transfer-record query does not reflect a newly submitted application immediately.
  • For the complete workflow, see Reservations and Transfers.
Finding target_branch_no

Enter the TDCC code for the receiving securities branch. Do not use a bank branch code or an internally assigned branch ID.

  1. Start with the TWSE securities firm directory to confirm the broker.
  2. For a Fubon Securities branch, use the Fubon branch-code details to confirm the specific branch code.
  3. Enter the code exactly as listed, including letters and digits (for example, "960C").

Parameters

FieldTypeDescription
accountAccountSource account
target_branch_nostringTDCC code for the receiving securities branch
target_accountstringReceiving account
stock_nostringStock symbol
quantityintNumber of shares to transfer. Unit: shares; must be greater than 0
marketMarket (optional)Market: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging. When omitted, the SDK resolves it automatically

Result

FieldTypeDescription
is_successboolWhether the request succeeded
dataTransferRecordStock transfer application details
messagestringError message when is_success is false

Transfer record: TransferRecord fields

Return type : Object

FieldTypeDescription
seq_nostringSequence number
datestringApplication date
timestringApplication time
stock_nostringStock symbol
marketMarketMarket: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging
quantityintTransferred shares
target_branch_nostringTDCC code for the receiving securities branch
target_accountstringReceiving account
statusintStatus: 10 success; 90 failure

Request example

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

Response example

Result {
is_success: True,
message: None,
data : TransferRecord {
date: "2026/07/28", # Application date (string)
time: "10:53:48.340", # Application time (string)
seq_no: "418181", # Sequence number (string)
stock_no: "006205", # Stock symbol (string)
market: Taiex, # Market (Market)
quantity: 2000, # transferred shares (int)
target_branch_no: "960C", # Receiving securities branch TDCC code (string)
target_account: "7654321", # Receiving account (string)
status: 10, # status (int)
}}