Skip to content
Longport WhaleLongport Whale
Global Limit

Set Global Limit Status

Enables or disables a single global trading-limit configuration, toggling its effective state via enable.

Request parameters

  • Required: code (limit configuration code), enable (whether to enable)
  • Optional: audit_frontend_resource (caller-provided audit context)
  • See the field notes for each field's format, value range, and business meaning.

Business notes

A global limit applies to all trading, so toggling it immediately changes its constraint on subsequent trades. This endpoint only switches the effective state; it does not change the limit thresholds.

Risk warning

This operation changes the live effective state of a global trading limit, affecting all trading; the risk is very high. Re-confirm the target code and enable value before calling.

Result

On success, the global limit is enabled or disabled; the resulting state and returned data follow the 200 response definition.

POSThttps://b-api.lbkrs.com/risk_limit/v1/global/reverse

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_risk_limit_config.risk_limit_config_global_update

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

Request body application/json

codestringrequired

Limit config code. Taken from the current row's record.code, identifying which global-limit configuration this is.

enablebooleanrequired

Enable flag. true enables and false disables. Enable passes the negated current value, normally true; Disable passes the opposite, normally false.

Values
true
Enabled
false
Disable
audit_frontend_resourceobject

Frontend audit log metadata. Audit-only metadata, not a business parameter. $action is add when enabling or delete when disabling; $behavior contains the localized audit description.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.
Standard response envelopecodemessagedata
dataobjectdata structure

On success data is an empty object.

No nested fields

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