Skip to content
Longport WhaleLongport Whale
Client Stock Margin

Expire Client Long Margin Ratio

Expires (deactivates) a client's long-position stock margin-ratio record with immediate effect.

Request parameters

  • Required: aaid, counter_id. Locate the record with expire_at, or with member_id plus account_type.
  • See the field notes for each field's format, value range, and business meaning.

Business notes

Once expired, the record no longer serves as the client's effective margin configuration for that security, and risk control falls back to the default or higher-level margin rules.

Risk warning

This operation terminates a live margin configuration and directly affects the client's financing and force-liquidation determination. Verify the target record before calling.

Result

On success, the record is expired; the resulting state and returned data follow the 200 response definition.

POSThttps://b-api.lbkrs.com/risk/v1/account_stock_margin_ratio/expire

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_margin_ratio.account_margin_ratio_query

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

Request body application/json

aaidintegerrequired

Internal securities account ID aaid (numeric), not the account number account_no.

counter_idstringrequired

Security code in the form {type}/{market}/{code}, e.g. ST/US/AAPL.

expire_atinteger

Expiry time as a Unix timestamp in seconds.

member_idstring

Client ID member_id.

account_typeinteger

Account type code; used together with member_id to locate the record.

Responses

HTTP 200OK
Standard response envelopecodemessagedata
dataobjectdata structure
ticket_idstring
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