Business API
Exchange money
api
post
/exchange

Exchange money

Exchange money using one of these methods:

  • Sell currency: You know the amount of currency to sell. For example, you want to exchange 135.5 USD to some EUR.

    Specify the amount in the from object.

  • Buy currency: You know the amount of currency to buy. For example, you want to exchange some USD to 200 EUR.

    Specify the amount in the to object.

note

You must specify the amount field only once, either in the from object or in the to object.

For more information, see the guides: Exchange money.

Request​

Specify the exchange information

Request body
Body object 

Response​

Exchange operation details

Response body
Body object 
Was this page helpful?
POST
/exchange . 
curl -L -X POST 'https://b2b.revolut.com/api/1.0/exchange' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "from": {
    "account_id": "af98333c-ea53-482b-93c2-1fa5e4eae671",
    "currency": "USD",
    "amount": 135.5
  },
  "to": {
    "account_id": "b7ec67d3-5af1-42c8-bece-3d285774894d",
    "currency": "EUR"
  },
  "reference": "exchange",
  "request_id": "A1pH4num3ric2"
}'
Request body samples
{
  "from": {
    "account_id": "af98333c-ea53-482b-93c2-1fa5e4eae671",
    "currency": "USD",
    "amount": 135.5
  },
  "to": {
    "account_id": "b7ec67d3-5af1-42c8-bece-3d285774894d",
    "currency": "EUR"
  },
  "reference": "exchange",
  "request_id": "A1pH4num3ric2"
}
Response body samples
{
  "id": "630f9c2e-2e74-a06d-ab61-deb7ggkkd6cb",
  "state": "completed",
  "created_at": "2022-08-31T17:36:46.656876Z",
  "completed_at": "2022-08-31T17:36:46.657239Z"
}