Save IPO Rate

Creates or edits an IPO commission-rate configuration.

Request parameters

Required: name (rate name), currency, financing_rate, buy_fee, sfc_transaction_levy, transaction_fee, transaction_levy, commission (broker commission), lb_commission (Longbridge commission), audit_frontend_resource (audit context).
Optional: id (rate ID, passed when editing).
currency candidate values vary by business; call GET /v1/datasets/refs/tenant_currencies_by_channel to obtain the currently available values.
See the field definitions for format, value ranges, and business meaning.

Business notes

Omitting id creates a new configuration; passing an existing id edits it. Rate items are expressed as percentages or amounts in the given currency; see the field definitions.

Risk warning

This operation changes real IPO commission-rate configuration and directly affects fee calculation for IPO trades. Confirm the parameters before calling.

Result

On success the IPO commission-rate configuration is created or updated. Refer to the 200 response definition for returned data.

POSThttps://b-api.lbkrs.com/v2/ipo/rate/save

Authorization

AuthorizationstringheaderRequired

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

Permission

ipo.financing_rate

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

Request body application/json

idstring

Pass the existing record id when editing; not sent when creating.

namestringrequired

This field is required.

currencystringrequired

Values come from the tenant_currencies_by_channel dynamic enumeration, e.g. HKD/USD.

Call GET /v1/datasets/refs/tenant_currencies_by_channel to retrieve the current data dictionary, and use the returned entry's key as this field's value.

financing_ratenumberrequired

A percentage value, e.g. 2.5 means 2.5%.

buy_feenumberrequired

The amount denominated in the currency given by currency.

sfc_transaction_levynumberrequired

A percentage value; when "More settings" is collapsed, the default rate is auto-filled and submitted.

transaction_feenumberrequired

A percentage value; when "More settings" is collapsed, the default rate is auto-filled and submitted.

transaction_levynumberrequired

A percentage value; when "More settings" is collapsed, the default rate is auto-filled and submitted.

commissionnumberrequired

A percentage value; when "More settings" is collapsed, the default rate is auto-filled and submitted.

lb_commissionstringrequired

Fixed to the string "0.00"; not user-editable.

audit_frontend_resourceobjectrequired

Records a snapshot of the rate data before and after the change and the operation type ($action: add/edit), used for backend audit trails; attached on every submission.

Responses

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