Exchange money

You can use the Business API to:

• Get sell exchange rates between two currencies with accompanying fees
• Make a foreign exchange to sell or buy currency

Get an exchange rate​

To get a sell exchange rate, provide the following details:

• from: The currency that you want to sell, i.e. from which you want to make the exchange.
• amount: The amount of the currency that you want to sell. If you don't provide it, it defaults to 1.00.
• to: The currency that you want to exchange the money to.

For example, to get the rate for an exchange of 100 EUR to USD, make the following request:

curl -L -X GET 'https://b2b.revolut.com/api/1.0/rate?from=EUR&amount=100&to=USD' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <your access token>'

In the response, you get the proposed exchange rate and expected accompanying fees, as well as the date of the proposed exchange rate.

To see example requests and responses:

See the API reference: Get an exchange rate

Make a foreign exchange​

You can exchange money using one of these methods:

You sell currency when you know the amount of currency from which you want to exchange money.
For example, you want to exchange 135.5 USD to some EUR.

To sell currency, provide the following details:

• from: The details of the account and currency from which you want to make the exchange.
  • account_id: The ID of the account from which you want to sell currency.
  • currency: The currency from which you want to exchange money.
  • amount: The amount of currency that you want to sell.
• to: The details of the account and currency to which you want to make the exchange.
  • account_id: The ID of the account to which you want to receive the exchanged currency.
  • currency: The currency to which you want to exchange money.

note

• Depending on the country and amount, you might also need to specify the exchange_reason_code.
• Optionally, you can also provide a reference for your exchange transaction so that you can easily identify it later.

For example, to sell 135.50 USD for EUR, make the following request:

curl -X POST https://b2b.revolut.com/api/1.0/exchange \
  -H "Authorization: Bearer <your access token>" \
  -d '{
        "from": {
          "account_id": "d56dd396-523b-4613-8cc7-54974c17bcac",
          "currency": "USD",
          "amount": 135.5
        },
        "to": {
          "account_id": "a44dd365-523b-4613-8457-54974c8cc7ac",
          "currency": "EUR"
        },
        "reference": "Time to sell",
        "request_id": "e0cbf84637264ee082a848b"
      }'

In the response, you get the exchange transaction ID, state, and creation and completion time.

To see example requests and responses:

See the API reference: Exchange money