Skip to content
Longport WhaleLongport Whale
Client Short Margin

Expire Client Short Margin Ratio

Expire a client's short-selling stock margin-ratio record so that the client's short margin configuration for a given security stops taking effect.

Request parameters

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

Business notes

Once expired, the record no longer participates in margin calculations for the client's short positions, and the client falls back to the default or higher-level margin rules.

Risk warning

This operation expires a client-level short margin configuration and directly affects margin and forced-liquidation decisions on the client's short positions. Confirm the target record before calling.

Result

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

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

Authorization

AuthorizationstringheaderRequired

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

Permission

margin_ratio.account_short_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