Update Rate Reference

Update Rate Reference.

Request parameters

Required: id (Rate Reference ID), channel_name (Exchange Channel), from_currency (From Currency), to_currency (To Currency), spread_mode (Spread Mode), bp (Spread Value)
Optional: audit_frontend_resource (Audit Frontend Resource (Before Edit))
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.lbkrs.com/forex/rate_reference_update

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_conversion.rate_reference_update

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

Request body application/json

idstringrequired

The ID of the reference-exchange-rate record to edit, taken from the list row data; required when editing.

channel_namestringrequired

The rate-source channel code; the allowed values come from ref spot_forex_sources.

from_currencystringrequired

A three-letter currency code; the allowed values come from the caller ref tenant_currencies_for_exchange.

to_currencystringrequired

Three-letter currency code; the allowed values come from the caller ref tenant_currencies_for_exchange, and it is mutually exclusive with from_currency.

spread_modestringrequired

Enum from the caller ref forex_spread_mode; in client logic, when the value is RATE the markup is by percentage (%), otherwise the markup is a fixed value.

Values

VALUE: Value
RATE: Ratio

bpstringrequired

Range 0-100, up to 4 decimal places (client validation regex /^\d+(.\d{1,4})?$/); when spread_mode is RATE it means a percentage markup, otherwise a fixed-value markup.

audit_frontend_resourceobject

A snapshot of the original record before editing (client originData/queryData), used only for back-office audit trail; not a business field.

Responses

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