Edit Token Exchange Rate

Access prerequisites

• Permission (module): updateExchangeRate (or manageToken)
• License/Feature: MANAGE_TOKENS
• Menu location: TOKENIZATION → group Tokenization → Manage Tokens → Exchange Rate icon on the row

What it is / when to use

Defines the exchange rate of a token manually. Useful for tokens with a fixed rate (no automatic provider), one-off corrections, or administrative adjustments. The rate is recorded with a date, so each update becomes a point in the token's rate history.

Prerequisites

• Permission: updateExchangeRate or manageToken (dual — CPM enum + module in DB).
• License/Feature: MANAGE_TOKENS.

Step by step

1. In Manage Tokens, click the Exchange Rate icon on the token's row.
2. Enter the reference currency and the new rate.
3. Confirm. The rate is saved via storeExchangeRateInformation.

Fields

Field	Description	Required?	System/backend effect
Reference currency	Currency in which the rate is expressed	Yes	Sent as referenceCurrency.
New rate	Rate value	Yes	Sent as rate (BigNumber). Must be >= 0.
Date	Moment of the rate	Automatic	date = new Date() — records the point in history.

Actions and modals

• Save: records the rate (storeExchangeRateInformation). Success and error are signalled by a snackbar ("Quote updated" / "Error updating the quote").

Business rules / caveats

Attention

• The manual update overrides the current rate, but if the token has an automatic provider (cmc_name filled in), the next rate cycle may overwrite the manual value. To fix a rate, leave the provider empty.
• The average price per user (calculated at purchase time) remains the one used in that user's operations — the rate here affects new operations, not the average price already formed.

• Financial values: the rate is BigNumber — no rounding.

Related screens

• Manage Tokens
• Manage Quotas