Skip to content
Billing Setup

Save IPO Rate

Save IPO Rate.

Request parameters

  • Required: name (Rate Name), currency (Currency), financing_rate (Financing Rate), buy_fee (Buy Fee), sfc_transaction_levy (SFC Transaction Levy), transaction_fee (Transaction Fee), transaction_levy (Transaction Levy), commission (Brokerage Commission), lb_commission (Longbridge Commission), audit_frontend_resource (Audit Context)
  • Optional: id (Rate ID)
  • See each field for its format, allowed values, and business meaning.

Result

On success, the endpoint completes the operation. See the 200 response schema for returned data and subsequent state information.

POSThttps://b-api.longbridge.xyz/v2/ipo/rate/save

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

idstring

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

namestringrequired

Specifies Rate Name. 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.
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