Create an FX quote

Last updated: 14th July 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

Header	Value
`Authorization` required	`Bearer {OAuth Bearer access token}`
`Content-Type` required	`application/json`

Body parameters

Field name	Description
`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

{
  "source_currency": "EUR",
  "destination_currency": "USD",
  "destination_amount": 100
}

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.

{
  "id": "qte_4cupy6wqbvbereowvw4mjcb2qi",
  "expires_on": "2020-12-04T11:14:09.1599802Z",
  "source_amount": 84,
  "source_currency": "EUR",
  "destination_amount": 100,
  "destination_currency": "USD",
  "rate": 1.19287971,
  "is_single_use": false
}