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
quantitynumberNumber 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
messagestring ? (optional)Error 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
quantitynumberTransferred shares
targetBranchNostringTDCC code for the receiving securities branch
targetAccountstringReceiving account
statusnumberStatus: 10 success; 90 failure

Request example​

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

Response example​

{
isSuccess: true,
data: {
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)
}
}