Skip to content
Profile and Changes

Change Account-Opening Profile

Submits a request to change the account-opening profile, used on the Personal profile page to change the ID document, address, tax information, or net asset value. Submit by module: include only the modules you change, and send the complete object of each module (take the module from GET /v4/member/account/open_info and overwrite the changed fields). Modules you do not submit stay unchanged.

A successful call means only that the request has been accepted; the change takes effect after review. Afterwards, call POST /v1/member/account/get_application_update_review_info to query the review status of each module. Do not resubmit a module whose review status is 0 (under review) or 3. On failure, show message to the Client.

The profile edit pages require the Client to unlock trading first. When you call this endpoint through WhaleCore requestService(), set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v1/member/account/update_application_info

Request body application/json

application_idstringrequired

Account-opening application ID. Use application_id from GET /v4/member/account/open_info, sent as a string.

open_infoobjectrequired

Profile modules changed in this request; include at least one module

Child attributes
uploadobject

ID document module. upload holds the account-opening ID document; bcan holds the document registered for the Hong Kong Broker-to-Client Assigned Number (BCAN).

Child attributes
regionstring

Country or region code of the issuing authority

card_countrystring

Country or region code the document belongs to

card_typeinteger

ID document type code, using the same values as card_type in the account list

card_idstring

ID document number

first_namestring

Given name on the document

last_namestring

Surname on the document

valid_date_endstring

Expiry date of the document

ic_front_assets_idstring

File ID of the front image of the document

ic_back_assets_idstring

File ID of the back image of the document

bcanobject

ID document module. upload holds the account-opening ID document; bcan holds the document registered for the Hong Kong Broker-to-Client Assigned Number (BCAN).

Child attributes
regionstring

Country or region code of the issuing authority

card_countrystring

Country or region code the document belongs to

card_typeinteger

ID document type code, using the same values as card_type in the account list

card_idstring

ID document number

first_namestring

Given name on the document

last_namestring

Surname on the document

valid_date_endstring

Expiry date of the document

ic_front_assets_idstring

File ID of the front image of the document

ic_back_assets_idstring

File ID of the back image of the document

baseobject

Basic information and residential address module (base)

Child attributes
namestring

Full name

first_namestring

Given name

last_namestring

Surname

middle_namestring

Middle name

birth_datestring

Date of birth in YYYY-MM-DD format

genderstring

Gender:

  • male - Male
  • female - Female
Values
male
female
educationstring

Education level dictionary code

marital_statusstring

Marital status dictionary code

residence_countrystring

Country or region code of the residential address

residence_partstring

Province, city, and district of the residential address

residence_descstring

Street address

residence_assets_idstring

File ID of the proof of address. Look up its preview URL in assets_map in the response.

employobject

Employment and tax module (employ)

Child attributes
typestring

Employment status dictionary code, such as retired, unemployed, or homemaker

companystring

Employer name

occupationstring

Occupation dictionary code

business_typestring

Employer industry dictionary code

yearsstring

Years-of-employment dictionary code

emailstring

Contact email

address_countrystring

Country or region code of the employer address

address_partstring

Province, city, and district of the employer address

address_descstring

Employer street address

taxesarray<object>

Tax residency entries

Child attributes
countrystring

Country or region code of tax residency, such as CN or HK

idstring

Taxpayer identification number in that country or region

financeobject

Financial status module (finance)

Child attributes
estimatedstring

Net asset value range dictionary code

income_levelstring

Annual income range dictionary code

funds_sourcestring

Source-of-funds dictionary code

funds_source_otherstring

Description entered when the source of funds is “Other”

wealth_sourcestring

Source-of-wealth dictionary code

investobject

Investment experience and objectives

Child attributes
purposestring

Investment objective dictionary code

risk_tolerancestring

Risk tolerance dictionary code

stockstring

Stock investment experience dictionary code

optionstring

Options investment experience dictionary code

derivativesstring

Derivatives investment experience dictionary code

trade_timesstring

Trading frequency dictionary code

Responses

HTTP 200The request succeeded. The response body contains the result of the “Change Account-Opening Profile” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

No business data

No nested fields

Whale Docs