Rates Markets

Returns the list of available fee-display markets (tabs).

Request parameters

This endpoint has no required parameters.

Business notes

This endpoint is the candidate source for the tab filter value used by the client-facing fee-display datasets: the tab of booking_account_fee_info_items and booking_item_copywritings is drawn from the tabs[].tab returned here. The candidate values change dynamically, so rely on the live response of this endpoint.

Returns

On success, returns the list of available fee-display markets in data.tabs. See the response definition below for field meanings.

GEThttps://b-api.lbkrs.com/v1/billing/myrates/markets

Authorization

AuthorizationstringheaderRequired

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

Permission

billing.account_fee_info_manage

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

Responses

HTTP 200The request was processed successfully. data.tabs is the list of available market tabs.

Standard response envelopecodemessagedata

dataobjectdata structure

tabsarray<object>

List of available market tabs. Each item's tab is the value used for the datasets' tab filter.

Child attributes

tabstring

Tab / filter value (market code), e.g. HK, US, US_OPTIONS, HAS.

namestring

Tab display name, e.g. HK, US Options, Crypto - HashKey.

biz_typeinteger

Business type, e.g. 1 securities market, 5 US options, 9 crypto.

marketstring

Market code.

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/billing/myrates/markets' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "tabs": [
      {
        "tab": "HK",
        "name": "HK",
        "biz_type": 1,
        "market": "HK"
      },
      {
        "tab": "US",
        "name": "US",
        "biz_type": 1,
        "market": "US"
      },
      {
        "tab": "US_OPTIONS",
        "name": "US Options",
        "biz_type": 5,
        "market": "US"
      },
      {
        "tab": "HAS",
        "name": "Crypto - HashKey",
        "biz_type": 9,
        "market": "HAS"
      }
    ]
  }
}