> For the complete documentation index, see [llms.txt](https://docs.b2core.b2broker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2core.b2broker.com/how-to-articles/manage-currencies/how-to-configure-currency-exchange-rates.md).

# How to configure currency exchange rates

You can configure exchange rates for currencies and set up rate providers to ensure accurate currency conversions when needed for transaction processing.

To set up a rate provider:

{% stepper %}
{% step %}
Navigate to **Currencies** > **Rates**.
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
On the displayed page, fill in the following fields:

* In the **From currencies** and **To currencies** dropdowns, select the currencies for which you want to configure exchange rates.

  You can select one or multiple currencies in the dropdowns, or choose **All** to apply the configured rates to all currencies.
* In the **Provider** dropdown, select the desired provider for currency rates.
* In the **Name** field, enter a name for your exchange rate configuration.
  {% endstep %}

{% step %}
Click **Save** to create the provider.
{% endstep %}

{% step %}
In the rates list, find the provider that you've created and click **Edit** to enter the provider details.
{% endstep %}

{% step %}
If additional settings are required for the provider, the **Options** section is displayed, enabling you to configure connection details for the provider.

If using the **custom** provider, fill in the following fields in **Options**:

* In the **Rate** field, enter the fixed rate that will be used for conversions.
* In the **Base currency** dropdown, select the currency that will serve as the base for all conversions using the specified fixed rate.
  {% endstep %}

{% step %}
In the **Enabled** dropdown, select **Yes**.
{% endstep %}

{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}

After setting up the rate provider, you can designate it as the preferred provider to supply exchange rates for [deposit](/back-office-guide/system/deposit-system.md#deposit-methods) and [withdrawal methods](/back-office-guide/system/payout-system.md#payout-methods). If a provider is assigned to a specific method, the system will prioritize requesting rates from this provider when the method is used.

## Example

This example illustrates the settings for a custom exchange rate for `USD/EUR`:

* `USD` is selected in the **From currencies** field and `EUR` in the **To currencies** field.
* In the **Provider** dropdown, **custom** is selected.
* The **Enabled** option is set to **Yes**.

In the **Options** section:

* The **Rate** field displays `0.86`, which is the specified custom exchange rate.
* The **Base currency** is set to USD.

<figure><img src="/files/Mb8DKz2R2MD31Lk75eck" alt="Custom exchange rate settings"><figcaption><p>Custom exchange rate settings</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.b2core.b2broker.com/how-to-articles/manage-currencies/how-to-configure-currency-exchange-rates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
