Skip to content
Longport WhaleLongport Whale
Fee Rate and Other Charges

Account Final Fees

Retrieves the final effective fee configuration for a customer by aaid (v4).

Request parameters

  • Required: aaid (customer account identifier)
  • Optional: policy_version (billing policy version; omit or pass 0 for the currently effective version)

Business notes

The result is grouped by market and reflects the customer's actually effective rates after packages, organization fees, and personalized fees are layered together.

Returns

On success, returns the customer's final effective fee configuration grouped by market in data.tabs. See the response definition below for the meaning of each level.

GEThttps://b-api.lbkrs.com/v4/billing/account_final_fees

Authorization

AuthorizationstringheaderRequired

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

Parameters

aaidstringRequired

Customer account identifier (aaid).

Pass the internal numeric ID of the customer's securities account (aaid), not the securities account number account_no (such as H00000000) or the customer ID member_id. One customer can have multiple aaid values.

policy_versionstring

Billing policy version. Omit or pass 0 for the current effective version.

Responses

HTTP 200The request was processed successfully. data.tabs contains the final fee configuration grouped by market.
Standard response envelopecodemessagedata
dataobjectdata structure
tabsarray<object>

List of fee tabs grouped by market.

Child attributes
namestring

Tab name, e.g. market-HK (by market).

cardsarray<object>

List of fee cards under this market.

Child attributes
biz_typeinteger

Business type.

affgsarray<object>

Fee aggregation list. Each item contains:

  • item: charging scene configuration; fields are the same as "Charging Scene Detail".
  • prm_fee: primary fee configuration (currency, min / max, rates tiered rates, package_id / package_name, level, etc.).
  • special_fees: special rate list; each item has conditions and its own rate parameters.
Child attributes
itemobject
prm_feeobject
special_feesarray<object>
showstring

Tab display flag (string).

packageobject

Billing package currently applied to the customer, with sub-fields such as id, name, type, member_count, and merge_rules.

policy_versionstring

Billing policy version the returned result corresponds to.

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