Skip to content

Create an FX quote

Last updated: April 29, 2022

Our Foreign Exchange (FX) API allows you to request FX quotes, so you can make international transfers in the way that suits your business needs.

The quotes endpoint returns an exchange rate in your preferred operating currency, allowing you to assess the rate, before making the transfer.

Create a quote

Generate an FX quote with the following endpoint. You can then use the unique quote id you get in the response to make a payout at the quoted rate. To get a detailed view of all required and optional fields, see our API reference.

Endpoints

post

https://api.checkout.com/forex/quotes

Header parameters

HeaderValue

Authorization

required

Bearer {OAuth Bearer access token}

Content-Type

required

application/json

Body parameters

Field nameDescription

source.currency

required

string

The three-letter ISO code of the debiting currency of your chosen currency account.

source.amount

optional

integer

The amount to be converted from the source currency.

The exact format depends on the currency.

destination.currency

required

string

The destination three-letter ISO currency code.

destination.amount

optional

integer

The amount to be converted to the destination currency.

The exact format depends on the currency.

Request examples

1
{
2
  "source_currency": "EUR",
3
  "destination_currency": "USD",
4
  "destination_amount": 100
5
}

Response example

You will receive a response containing the quote id, the exchange rate, and the date and time the quoted rate is valid until.

1
{
2
  "id": "qte_4cupy6wqbvbereowvw4mjcb2qi",
3
  "expires_on": "2020-12-04T11:14:09.1599802Z",
4
  "source_amount": 84,
5
  "source_currency": "EUR",
6
  "destination_amount": 100,
7
  "destination_currency": "USD",
8
  "rate": 1.19287971,
9
  "is_single_use": false
10
}