Skip to content
Account Transfers

Submit Stock Transfer

Moves one stock between a Client's main account and sub-account. Each request transfers only one stock. To transfer several stocks, call this operation once per stock and use the same ref_no for every request in the batch. That value is the batch number batch_no, which you can use with GET /v1/app/risk_event_api/query_stock_transfer_tickets to query the batch.

Before submitting, call GET /v1/app/risk_event_api/is_over_transfer_limit with type=0 to make sure no limit is exceeded, and ask the Client to confirm the transfer details. A successful response only means the request for that stock was accepted. The final status of each stock is stocks[].status in the batch record. If any stock fails to submit, stop submitting the remaining stocks, show message to the Client, and query the batch record to see which stocks were accepted.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v1/app/rms_gateway/omnibus_stock_transfer

Request body application/json

from_aaidintegerrequired

aaid of the source account

to_aaidintegerrequired

aaid of the destination account

counter_idstringrequired

Security ID to transfer, from list[].counter_id of GET /v1/app/risk_event_api/query_stock_transfer_holding

transfer_amountstringrequired

Number of shares to transfer, as a positive integer string

transfer_typeintegerrequired

Transfer direction:

  • 0 - To the main account
  • 1 - To a sub-account
Values
0
1
account_channelstringrequired

Account channel of the source account

equity_typestringrequired

Asset type to transfer. Always STOCK

Values
STOCK
is_enable_dynamic_calculate_modebooleanrequired

Whether to enable dynamic calculation mode. The Broker App always sends true

operation_typestringrequired

Operation source. The Broker App always sends app

ledger_timeintegerrequired

Submission time as a Unix timestamp in milliseconds

ref_nostringrequired

Batch request number, such as a UUID. Use the same value for every stock in the batch

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Stock Transfer” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Acceptance result. Treat code equal to 0 as success

No nested fields

Whale Docs