Instant Trade

For scenarios where simplicity and automation is of key importance, our BC Instant Trade endpoint enables you to execute trades using a simple POST request.

The transaction will be done in market order fashion: your deal will be filled at the prevailing FX market rate and you will receive an instant confirmation with the relevant trade details such as the exchange rate and converted amounts.

Each transaction will be settled on your currency accounts immediately following our confirmation, with the exception of bank holidays where the settlement moves to the next available date instead. You may specify 'TN' in the tenor field for next-day or 'SPOT' for SPOT settlement.

📘

Multiple legal entities?

If you have multiple legal entities or a company structure that requires the use of multiple companies in BC Connect context, you should additionally specify the (optional) customerId field in the order to ensure the trade lands on correct bank accounts. You can retrieve the customerId by calling the Accounts endpoint. Here the parameter is called companyNumber.

Below is an example FX Trade POST request where you are buying 10,000 EUR against GBP with value date today. The customerId field is optional and should be used only in case of multiple legal entities.

{  
  "clientOrderId": "YourUniqueReference",  
  "buyCurrency": "EUR",  
  "sellCurrency": "GBP",  
  "amount": 10000,  
  "amountCurrency": "EUR",  
  "tenor": "ON",  
  "customerId": "000012356"  
}

// customerId is optional: use it if you have multiple legal entities

In response, our API will confirm the trade with exchange rate and your sold GBP amount.

{  
  "tradeStatus": "Filled",  
  "clientOrderId": "YourUniqueReference",  
  "bankingCircleRef": "2110081351166",  
  "customerId": "000012356",  
  "boughtCurrency": "EUR",  
  "boughtAmount": 10000,  
  "soldCurrency": "GBP",  
  "soldAmount": 8492.99,  
  "currencyPair": "EURGBP",  
  "exchangeRate": 0.8492993,  
  "valueDate": "2021-10-08"  
}

Similarly, you can choose to buy X EUR by selling 10,000 GBP, in which case the converted amount will be in EUR.

📘

Use clientOrderId or bankingCircleRef to query for or reconcile your FX transactions

The client order id in your order as well as the BC Connect reference in your trade confirmation can be used as search criteria to retrieve further details about your transactions via our FX transactions endpoint. BankingCircleRef is furthermore available in the account reconciliation endpoint in field PaymentDetails3.

Trading Limits

For each of our supported currencies, we also have a maximum amount you may trade in a single trade. These are listed in the Trading Limits page.