Skip to main content

Stock Transfer Application

TransferStock

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 targetBranchNo

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
targetBranchNostringTDCC code for the receiving securities branch
targetAccountstringReceiving account
stockNostringStock 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
isSuccessboolWhether the request succeeded
dataTransferRecordStock transfer application details
messagestringError message when isSuccess is false

Transfer record: TransferRecord fields​

Return type : Object

FieldTypeDescription
seqNostringSequence number
datestringApplication date
timestringApplication time
stockNostringStock symbol
marketMarketMarket: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging
quantityintTransferred shares
targetBranchNostringTDCC code for the receiving securities branch
targetAccountstringReceiving account
statusintStatus: 10 success; 90 failure

Request example​

sdk.Stock.TransferStock(account, "960C", "7654321", "006205", 2000)

Response example​

{
isSuccess = True,
message = ,
data = TransferRecord{
date = 2026/07/28, // Application date (string)
time = 10:53:48.340, // Application time (string)
seqNo = 418181, // Sequence number (string)
stockNo = 006205, // Stock symbol (string)
market = Taiex, // Market (Market)
quantity = 2000, // transferred shares (int)
targetBranchNo = 960C, // Receiving securities branch TDCC code (string)
targetAccount = 7654321, // Receiving account (string)
status = 10, // status (int)
}
}