Skip to content
Stock Margin Ratio

Add Stock Margin Ratio Adjustment Task (With Review)

Create a stock margin-ratio adjustment task and submit it for review.

Request parameters

  • Required: counter_id (security code), im_factor (initial margin ratio), mm_factor (maintenance margin ratio), fm_factor (forced-close margin ratio), mcm_factor (Margin Call ratio), trigger_at (effective date)
  • See the field descriptions for the format, value range, and business meaning of each field.

Business notes

Once submitted, the task enters the review flow. After approval and once the trigger_at date is reached, the security's margin ratios are updated.

Risk warning

This operation changes real margin ratios and carries very high risk. Confirm the security code, each margin ratio, and the effective date before calling.

Result

On success, the margin-ratio adjustment task is created and enters review. The resulting state and returned data follow the 200 response definition.

POSThttps://b-api.lbkrs.com/risk/v1/margin_ratio_task/add_review

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

counter_idstringrequired

Security code. Format is {type}/{market}/{code}, for example, stock ST/HK/700 or ST/US/AAPL, and option OP/US/AAPL270319C320000.

im_factorstringrequired

Initial margin ratio

mm_factorstringrequired

Maintenance margin ratio

fm_factorstringrequired

Force-liquidation margin ratio

mcm_factorstringrequired

Margin Call ratio

trigger_atnumberrequired

Effective date

remarkstring

Remark

operatorstring

operator

sourcestring

source

policynumber

Policy type

audit_frontend_resourceobject

audit_frontend_resource

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