Sign in

778890ee7e72

latestOpenAPI 3.0.02026-08-14100249502.6 KB
Conversions

Get an estimated conversion rate

Returns an estimated rate for an FX conversion between two currencies.

The rate, amount & fees are indicative only and the rate is not held - the rate applied when you create a conversion may differ.

Rate Limiting

This API enforces a stricter rate limit - if you exceed it you will receive a 429 Too Many Requests response. We recommend requesting a rate only when you need one rather than polling for rates.

Rate Availability

Rates are briefly unavailable during a short daily window (~90 seconds) while FX trading closes. During this window you will receive a 400 Bad Request response with a message indicating that rates are temporarily unavailable - retry shortly.

get/conversions/rate

Query parameters

sellCurrencystring required
Example:GBP

The three-letter ISO-4217 currency code to sell.

buyCurrencystring required
Example:EUR

The three-letter ISO-4217 currency code to buy.

amountinteger required
Example:100000

The amount to sell in minor units. Minimum and maximum amounts vary by currency.

Headers

Accountstring
Example:ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327

The linked accountId (use this to get an estimated rate for a specific sub account)

Response

Estimated rate retrieved successfully

ratenumber required

The gross exchange rate that would be applied, before fees. buy.amount is the converted sell amount at this rate, net of any sell-side fee.

estimatedSettlementDatestring nullable

The estimated date the conversion will settle (ISO date format). This is an estimate and may not exactly match the final settlement date.

Example response

{
  "sell": {
    "amount": 100000,
    "currency": "GBP",
    "fees": {
      "ryft": {
        "amount": 500
      },
      "platform": {
        "amount": 1000,
        "ryftFee": {
          "amount": 500
        }
      }
    }
  },
  "buy": {
    "amount": 86000,
    "currency": "EUR",
    "fees": {
      "ryft": {
        "amount": 500
      },
      "platform": {
        "amount": 1000,
        "ryftFee": {
          "amount": 500
        }
      }
    }
  },
  "rate": 0.86,
  "estimatedSettlementDate": "2024-03-15"
}