Skip to content
Currency Setup

Edit Currency Config

Edit a currency setting, used to maintain a currency's withdrawal, FX, precision, and display configuration.

Request parameters

  • Required: id (config ID), currency_iso (currency code), currency (currency identifier), icon, logo, support_withdraw, support_exchange, min_withdrawal_amount, min_exchange_amount, exchange_rate_precision, amount_precision, amount_round_mode, standard_money (whether it is the base currency), abbreviation_multi_name (localized short name), multi_name (localized full name), json_config (display and business toggles)
  • Optional: cash_amount (minimum deposit amount), remarks, audit_frontend_resource (caller-provided audit-log payload)
  • See each field's definition for its format, value range, and business meaning.

Business notes

Toggles such as support_withdraw and support_exchange are ultimately merged into json_config. abbreviation_multi_name and multi_name are localized JSON strings (with zh-CN, zh-HK, en).

Risk warning

This operation changes the currency's withdrawal, FX, and display configuration and may affect the funding services available to customers. Confirm the target currency and parameters before calling.

Result

On success the currency setting is updated; see the 200 response definition for the returned content.

PUThttps://b-api.lbkrs.com/atm/currency/config

Authorization

AuthorizationstringheaderRequired

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

Permission

atm.update_current_config

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

Request body application/json

idstringrequired

Config ID associated with this request.

currency_isostringrequired

This field is required.

currencystringrequired

Currency code used for this request. This field is required.

iconstringrequired

This field is required.

logostringrequired

This field is required.

cash_amountstring
min_withdrawal_amountstringrequired

This field is required.

min_exchange_amountstringrequired

This field is required.

exchange_rate_precisionnumberrequired

This field is required.

amount_precisionstringrequired

Number of decimal places retained for monetary amounts. This field is required.

Values
0
No decimal places
1
One decimal place
2
Two decimal places
amount_round_modestringrequired

This field is required. Values come from a backend data dictionary (maintained dynamically), not a fixed enum; use the options the service actually returns.

standard_moneystringrequired

Specifies Standard Money. This field is required.

Values
yes
Yes
no
No
remarksstring

Remarks saved with this operation.

abbreviation_multi_namestringrequired

A JSON string {zh-CN, zh-HK, en}.

multi_namestringrequired

A JSON string {zh-CN, zh-HK, en}.

json_configstringrequired

JSON string {app_show, support_withdraw, support_exchange, support_deposit}.

audit_frontend_resourceobject

Provides audit context for this operation.

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