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
statusreturned by this method as the result (10success;90failure). The transfer-record query does not reflect a newly submitted application immediately. - For the complete workflow, see Reservations and Transfers.
Finding
targetBranchNoEnter the TDCC code for the receiving securities branch. Do not use a bank branch code or an internally assigned branch ID.
- Start with the TWSE securities firm directory to confirm the broker.
- For a Fubon Securities branch, use the Fubon branch-code details to confirm the specific branch code.
- Enter the code exactly as listed, including letters and digits (for example,
"960C").
Parameters
| Field | Type | Description |
|---|---|---|
| account | Account | Source account |
| targetBranchNo | string | TDCC code for the receiving securities branch |
| targetAccount | string | Receiving account |
| stockNo | string | Stock symbol |
| quantity | number | Number of shares to transfer. Unit: shares; must be greater than 0 |
| market | Market (optional) | Market: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging. When omitted, the SDK resolves it automatically |
Result
| Field | Type | Description |
|---|---|---|
| isSuccess | bool | Whether the request succeeded |
| data | TransferRecord | Stock transfer application details |
| message | string ? (optional) | Error message when isSuccess is false |
Transfer record: TransferRecord fields
Return type : Object
| Field | Type | Description |
|---|---|---|
| seqNo | string | Sequence number |
| date | string | Application date |
| time | string | Application time |
| stockNo | string | Stock symbol |
| market | Market | Market: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging |
| quantity | number | Transferred shares |
| targetBranchNo | string | TDCC code for the receiving securities branch |
| targetAccount | string | Receiving account |
| status | number | Status: 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)
}
}