Skip to content
Longport WhaleLongport Whale
Short Selling Rate

Set Security Lending Rate

Modify the final fee rate of a securities-lending record.

Request parameters

  • Required: id (record ID), final_fee_rate (final fee rate)
  • See each field description for format, value range, and business meaning.

Business notes

Updates the final fee rate of the securities-lending record identified by id to final_fee_rate, used for subsequent interest billing.

Only records on the current clearing ledger date can be changed. Take the current clearing ledger date from the ledger_date returned by get_near_three_ledger_date, not from get_current_ledgedate (which returns the front-office ledger date and may already be ahead of clearing). Records on any other date return 802503 (only data of the current ledger date can be modified).

Risk warning

This operation affects real securities-lending interest billing. Confirm the target record and rate before calling.

Result

On success the fee rate is modified; refer to the 200 response for the resulting state and returned data.

POSThttps://b-api.lbkrs.com/clearing/security_lending_set_rate

Authorization

AuthorizationstringheaderRequired

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

Permission

billing.short_selling_management_operation

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

Request body application/json

idnumberrequired

Record ID associated with this request.

final_fee_ratestringrequired

This field is required.

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