Get Account Trade Permission

Returns the trading permissions granted to a securities account.

Request parameters

This endpoint has no required parameters; see the field definitions for optional parameters.
See the field definitions for each field's format, allowed values, and business meaning.

Business notes

Returns the list of granted permissions; each entry includes the permission type (for example, stock or va for virtual assets) and the supported markets (such as HK, US).

Returns

On success, returns the account trading-permission list. See the response definition for field meanings.

GEThttps://b-api.lbkrs.com/v1/whaleapi/account/trade_permissions

Authorization

AuthorizationstringheaderRequired

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

Permission

account.trade_permission

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

Parameters

account_nostringRequired

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.

Responses

HTTP 200Successful response

Standard response envelopecodemessagedata

dataobjectdata structure

permissionsarray<object>required

permissions

Child attributes

productstringrequired

Account permission type. Common value: stock

marketsarray<string>required

markets

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

Request

curl --request GET \
  --url 'https://b-api.lbkrs.com/v1/whaleapi/account/trade_permissions' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "permissions": [
      {
        "product": "1",
        "markets": [
          "US"
        ]
      }
    ]
  }
}