Skip to content
Stock Transfer In

Submit Stock Transfer-In Request

Submits a request to transfer stocks from another broker into the current account. Typical flow: select the market (GET /v2/portfolio/rollover/markets) → select the delivering broker (GET /v2/portfolio/rollover/brokers) → search for and fill in the stocks (GET /v1/portfolio/stocks/search) → optionally upload supporting documents → confirm and call this endpoint.

A successful call means only that the request has been accepted; the stocks arrive after the delivering broker processes the transfer. On success, show the receiving broker information (GET /v3/portfolio/rollover/receiver) and guide the Client to notify the delivering broker; after the Client confirms, call POST /portfolio/rollover/mark. Then track progress with GET /v3/portfolio/rollover/record and GET /v2/portfolio/rollover/detail/{id}. On failure, show message to the Client and resubmit after correction.

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

POSThttps://api.lbkrs.com/v3/portfolio/stock/rollover

Request body application/json

marketstringrequired

Transfer market from market_code of GET /v2/portfolio/rollover/markets

broker_idstringrequired

Delivering broker id from id of GET /v2/portfolio/rollover/brokers; 0 means another broker not in the list, entered manually by the Client

brokerstringrequired

Delivering broker name; same as broker_en when broker_id is 0

broker_enstringrequired

Delivering broker name in English from name_en of the broker list; entered in English by the Client when broker_id is 0

codestring

Participant code of the delivering broker (such as CCASS for Hong Kong or DTC for the US); required when broker_id is 0

contactstring

English name of the contact at the delivering broker; required when broker_id is 0

contact_emailstring

Email of the contact at the delivering broker; required when broker_id is 0

contact_phonestring

Phone number of the contact at the delivering broker, optional

namestring

Account holder name of the Client at the delivering broker, which can be selected from GET /v1/portfolio/names; required when the Broker’s transfer-in flow collects delivering account information

accountstring

Account number of the Client at the delivering broker; required when the Broker’s transfer-in flow collects delivering account information

aaidstring

aaid of the receiving account; pass it only when the Client chooses the receiving account, otherwise omit it

attachmentsarray<string>

Object storage keys of the supporting documents, keys only and no URLs, up to 10; omit the field when there are no attachments instead of sending an empty array

stocksarray<object>required

Stocks to transfer in

Child attributes
counter_idstringrequired

Security ID, such as ST/HK/700

codestringrequired

Stock code

namestringrequired

Stock name

name_enstringrequired

Stock name in English

marketstringrequired

Market code, such as HK or US

currencystringrequired

Settlement currency from currency in the search result; requests without it are rejected

amountstringrequired

Quantity to transfer in

coststring

Cost price, optional; omit the field when not provided

account_channelstring

Broker channel

Responses

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

New transfer-in request id, used to query details

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs