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
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
target_branch_noEnter 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 |
| target_branch_no | string | TDCC code for the receiving securities branch |
| target_account | string | Receiving account |
| stock_no | string | Stock symbol |
| quantity | int | 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 |
|---|---|---|
| is_success | bool | Whether the request succeeded |
| data | TransferRecord | Stock transfer application details |
| message | string | Error message when is_success is false |
Transfer record: TransferRecord fields
Return type : Object
| Field | Type | Description |
|---|---|---|
| seq_no | string | Sequence number |
| date | string | Application date |
| time | string | Application time |
| stock_no | string | Stock symbol |
| market | Market | Market: Taiex TWSE, Taisdaq TPEx, Taiemg Emerging |
| quantity | int | Transferred shares |
| target_branch_no | string | TDCC code for the receiving securities branch |
| target_account | string | Receiving account |
| status | int | Status: 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)
}}