Skip to content
Longport WhaleLongport Whale
Account Profile & Status

Open additional account

Opens an additional main or sub account under a securities account.

Request parameters

  • Required: account_no (securities account), additional_account (additional-account details)
  • See the field definitions for each field's format, allowed values, and business meaning.

Business notes

additional_account specifies the type to add (main / sub account), the account type (cash / margin account; may be empty when adding a sub account), and a custom account name, and it initiates the additional-account request.

On success it returns the application ID application_id and the account type.

Risk warning

This operation creates a new trading account for the customer and changes the account structure. Confirm the target securities account and the additional-account parameters before calling.

Result

On success, an additional-account request is created and application_id is returned. The resulting state is defined by the 200 response.

POSThttps://b-api.lbkrs.com/v1/whaleapi/account/append_account

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

kyc.hk_account

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

account_nostringrequired

Account Number. Account Number

account_no is the securities account number (such as L6VQEU00121996). It differs from the customer ID member_id and the internal securities account ID aaid.

additional_accountobjectrequired

Additional Account Info. Additional Account Info

Child attributes
additional_typestringrequired

Additional Type. Additional Type

account_typestring

Account Type, Allowed empty when append sub account. Account Type, Allowed empty when append sub account

account_namestring

Custom Account Name. Custom Account Name

Responses

HTTP 200Success
Standard response envelopecodemessagedata
dataobjectdata structure
application_idstringrequired

Account Request ID. Account Request ID

account_typestringrequired

Account Type. Account Type

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs