Skip to content
Stock Transfer In

Modify Stock Transfer-In Request

Modifies the broker information, stocks, or supporting documents of a submitted stock transfer-in request. Used for the “Modify” action on the transfer-in records or details page. Only requests whose can_modify is 1 can be modified. The request body is the same as POST /v3/portfolio/stock/rollover plus id, and must contain the complete modified content, not only the changed fields; the Broker App can prefill the form from the record returned by the details endpoint.

On success, query the records and details again to refresh them. On failure, show message to the Client.

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

POSThttps://api.lbkrs.com/portfolio/rollover/receiver/modify

Request body application/json

idstringrequired

Transfer-in request id from id of the record

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 “Modify Stock Transfer-In Request” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

No business data; code 0 indicates success

No nested fields

Whale Docs