Skip to content
Longport WhaleLongport Whale
Margin Principal Inquiry

Upload Exempt Amount

Upload and register an interest-exempt principal file.

Request parameters

  • Optional: ledger_date (ledger date), file_key (uploaded file key)
  • See each field description for format, value range, and business meaning.

Business notes

Uses an upload-then-submit flow: first upload the interest-exempt principal file to obtain file_key, then submit it with ledger_date to register the interest-exempt principal for that ledger date.

Risk warning

This operation affects real interest-exempt principal calculation and subsequent billing. Confirm the ledger date and file contents before calling.

Result

On success the interest-exempt principal file is registered; refer to the 200 response for the resulting state and returned data.

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

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_clearing.billing_financing_interest_frozen

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

Request body application/json

ledger_datestring

Pass the clearing ledger date: the ledger_date returned by get_near_three_ledger_date. Do not use get_current_ledgedate; it returns the front-office ledger date, which may already be ahead of clearing, and calling with it returns 800008 (dependent task not finished).

file_keystring

Object-storage key returned after the file is uploaded; identifies the file to process.

Responses

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

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