---
title: "FX trade"
metaTitle: "FX trade"
order: 6
showPageMenu: true
---

import EndpointBlock from "src/components/endpoint-block";
import WebhookPlaceholder from 'src/components/webhook-placeholder'
import WebhookSummary from 'src/components/webhook-summary'
import Callout from "src/components/callout";

## Foreign exchange trade

Our FX trade offering allows you to buy and sell currency in real-time – you submit a trade order to ClearBank, we perform the required validation checks on your order and upon successful validation, execute it in the foreign exchange market against live market rates.

You can use our FX trade functionality to perform FX trades between accounts which belong to the same owner. For example, let’s assume that you want to sell GBP from Account A to purchase EUR for Account B – in doing so, you will need to ensure that the owner of both accounts is the same. This applies to two accounts that belong to you, that is, the financial institution or your customers.

When initiating a FX trade order via our API, you can either specify the amount of the currency you wish to buy or the amount you wish to sell. The specified amount (and currency) is referred to as the fixed side of the trade. Whereas the amount (and currency) that has not been specified is referred to as the floating side of the trade.

Additionally, you can also specify your margin (%) to be applied to the trade. The margin amount is automatically calculated, applied to the credit/debit Transaction amount of the buy and sell accounts, and credited to a separate account of your choice. The margin is always reflected in the calculation of the credit/debit transaction of the floating currency.

### Example: Specifying the sell amount with margin

**Trade Request:**

- InstructedAmount: 1000
- FixedSide: Sell
- BuyCurrency:  USD
- SellCurrency: GBP (This means the fixed side of the trade is GBP and the floating side is USD. Therefore, the margin will be in USD).
- Margin: 0.01 (Where 0.01 represents a 1% margin)
- Assume the ClearBank rate is: 1.40 for GBP/USD
- Margin amount: 1.4 x 0.01 x GBP 1000 = USD 14

**Resulting transactions in respective accounts:**

- Debit to the sellAccount: GBP 1000.00
- Credit to the buyAccount: USD 1386 [USD 1.4 x (1-0.01) x 1000]
- Credit to the specified margin account: USD 14

### Example: Specifying the buy amount with margin

**Trade Request:**

- InstructedAmount: 1400
- FixedSide: Buy
- BuyCurrency:  USD
- SellCurrency: GBP
- This means the fixed side of the trade is USD and the floating side is GBP, therefore the margin will be in GBP
- Margin: 0.01 (Where 0.01 represents a 1% margin)
- Assume the ClearBank rate is: 1.40 for GBP/USD
- Margin amount:  1400 / 1.4 x 0.01 = GBP 10

**Resulting transactions in respective accounts:**

- Debit to the sellAccount: GBP [1110 (1400 / 1.4 x (1 + 0.01)]
- Credit to the buyAccount: USD 1400
- Credit to the specified margin account: GBP  10

### FX trade minimum values

FX trades have minimum trading values defined for each currency. If you try to request a trade below these values, you will receive a 400 error response.

|   Currency       |  Currency code  | Minimum value|  
|------------------|------------|--------------|
| Canadian Dollar  |  CAD       |  17          |
| Swiss Franc      |  CHF       |  11          |
| Czech Koruna     |  CZK       |  279         |
| Danish Krone     |  DKK       |  86          |
| Euro             |  EUR       |  12          |
| British Pounds   |  GBP       |  10          |
| Hungarian Forint |  HUF       |  4411        |
| Norwegian Krone  |  NOK       |  134         |
| Polish Zloty     |  PLN       |  52          |
| Romanian Leu     |  RON       |  54          |
| Swedish Krona    |  SEK       |  135         |
| United States Dollar |  USD       |  13          |

<br />

### FX trade cut-off times

FX trades are subject to the cut-off times of both currencies in the trade. In order to execute a same-day trade, both currencies must be within their operating hours. A trade scheduled for next day or 2 days' time (indicated by a `valueDate` of T+1/T+2) can be executed for all currencies up to 23:30.

 * If a trade is booked in time for same-day settlement, you will receive a webhook notification of the settlement. If it fails to settle (typically because there are insufficient funds in the account), you will learn of the failure immediately. ClearBank will then send a [fx-trade-cancelled-v1](#fx-trade-cancelled-webhook) webhook.
 * If you attempt to book a trade but one or both currencies are outside of the operating hours, you will receive a 400 error response.
 * Trades scheduled for next day or 2 days' time are typically processed around 8am of the `valueDate`.
 * If a trade is booked, but cannot be settled until a later day, and the settlement fails, the [fx-trade-settlement-failed-v1](#fx-trade-settlement-failed-webhook) webhook notifies you of the failure. Make sure you subscribe to this webhook if you are making FX trades with a value (settlement) date later than the day of booking.

For further details on cut-off times, refer to the below table detailing the cut-off times for all currently supported currencies. Note that all times are in **UK time**.

|   Currency       |   Currency code   |   Start time   |   FX cut-off time (same day)   |   FX cut-off time (next day/2 days' time)   |  
|------------------|-------------------|----------------|--------------------------------|-------------------------------------------|
| Canadian Dollar  | CAD               | 07:00          | 17:00                          | 23:30                                     |
| Swiss Franc      | CHF               | 07:00          | 11:00                          | 23:30                                     |
| Czech Koruna     | CZK               | 07:00          | 08:30                          | 23:30                                     |
| Danish Krone     | DKK               | 07:00          | 11:00                          | 23:30                                     |
| Euro             | EUR               | 07:00          | 14:30                          | 23:30                                     |
| British Pounds   | GBP               | 07:00          | 15:00                          | 23:30                                     |
| Hungarian Forint | HUF               | 07:00          | 09:30                          | 23:30                                     |
| Norwegian Krone  | NOK               | 07:00          | 11:00                          | 23:30                                     |
| Polish Zloty     | PLN               | 07:00          | 09:30                          | 23:30                                     |
| Romanian Leu     | RON               | 07:00          | 08:30                          | 23:30                                     |
| Swedish Krona    | SEK               | 07:00          | 11:00                          | 23:30                                     |
| United States Dollar | USD           | 07:00          | 17:00                          | 23:30                                     |

<br/>

<Callout colour="blue">
Due to public holidays in the US, pricing of all currency pairs for our FX services will be limited or unavailable on the following dates:<br/>

•	**Monday 7th September (Labor Day)** <br/>
•	**Monday 12th October (Columbus Day)** <br/>
•	**Wednesday 11th November (Veterans Day)** <br/>
•	**Thursday 26th November (Thanksgiving Day)** <br/>
•	**Friday 25th December (Christmas Day)** <br/>

While same day trades may be unavailable on these dates, TOM/SPOT trades will be available to book. Please be mindful of TOM/SPOT trades booked in the days leading up to these dates.
</Callout>

<EndpointBlock
  type="post"
  title="Create a Foreign Exchange (FX) buy and sell order"
  endpoints={[
    {
      path: "/fx/v1/order",
      version: "1.0.FXO",
      webhooks: [
        'fx-trade-executed-v1',
        'fx-trade-settled-v1',
        'fx-trade-cancelled-v1',
        'fx-trade-settlement-failed-v1'
      ]
    }
  ]}
/>

## FX trade webhooks

<WebhookPlaceholder render='fx-trade-executed-v1' />
<WebhookPlaceholder render='fx-trade-settled-v1' />
<WebhookPlaceholder render='fx-trade-cancelled-v1' />
<WebhookPlaceholder render='fx-trade-settlement-failed-v1' />