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

    Copied!

    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
      3
      4
      5
      {
      "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.

        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        {
        "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
        }