Get FX quote

Get the current FX rate for a currency pair and receive a short-lived vfx_token for creating an FX trade.

📘

Check your base URL

Each Verto service has its own host. Use the base URL shown in the endpoint definition on this page — do not reuse a host from another service.

Sandbox hosts end in -sandbox.vertofx.com; the matching production host replaces sandbox with beta. Sending a request to the wrong environment returns 403.

See URLs (Sandbox vs Production) for the full service-by-service list.


📘

Rate and amount precision

The rate. The quote rate has no fixed number of decimal places. Verto calculates the base rate to up to 16 decimal places, then applies any client-specific markup without further rounding. Store the rate as a high-precision decimal and don't round it on your side. Round it only when you display it to users if required.

The amount. The amount you send must follow the decimal rules for its currency (amountCurrency): up to 2 decimal places for most currencies, whole numbers only for XOF, XAF and JPY, and multiples of 0.05 for KES. An amount that doesn't comply returns a 400. Most currencies are already enforced, and KES and JPY are accepted without errors until 30 January 2027. Verto's amounts are the final settlement figures, rounded to the currency's minor unit.

See Currency Decimal Support for the full rules and the list of currencies.

Body Params
string | null
enum
Defaults to immediate
Allowed:
string
enum
required
length between 3 and 3

source currency

string
enum
required
length between 3 and 3

destination currency

string
enum
required
length between 3 and 3

The amount currency e.g. GBP

float
required
≥ 0.01

Amount to be exchanged with up to two decimal places. Must be greater than zero.

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json