FX Transactions

Our API supports querying for your FX trades executed with us using various filtering criteria, including any transactions completed on our Real Time FX platform.

For example, if you have recently traded using YourUniqueReference in the clientOrderId field, you can query for this transaction using the FX Transactions endpoint as follows:

 {  
      "bankingCircleRef": "2110081357029",  
      "clientOrderId": "YourUniqueReference",  
      "tradeDate": "2023-05-01T09:24:23.952569",  
      "valueDate": "2023-05-03T00:00:00",  
      "boughtAmount": 10000,  
      "boughtCurrency": "EUR",  
      "boughtAccount": {  
        "accountId": "5fefb9c7-dd52-bb8b-3326-d79af1c7728",  
        "bankAccount": "DK7789000000000114"  
      },  
      "soldAmount": 8491.89,  
      "soldCurrency": "GBP",  
      "soldAccount": {  
        "accountId": "f88a4aad-5ca8-dc04-4941-1d97fbab6128",  
        "bankAccount": "DK9389000000000214"  
      },  
      "exchangeRate": 0.8491892,  
      "transactionStatus": "Settled"  
    }  
  ],  
  "pageInfo": {  
    "currentPage": 1,  
    "pageSize": 1  
  } 

Our API would then respond with your transaction details, including the settlement accounts used in the transaction:

You can also filter your transactions using other criteria, such as dates, accounts used, or currencies involved. All available filtering criteria are described in our API Reference section.

📘

Multicurrency Payments

Multicurrency Payments are not available from this endpoint as they are considered payments rather than FX trades. Please refer to the Single or Bulk Payments documentation for details on how to query for payments information

Trade lifecycle

All FX trades contain a transaction status when retrieved through the transactions endpoint. This status will indicate the current state of the transaction. All trades follow a standard lifecycle, which is as follows:

• Value date today with immediate settlement: Settled -> (only if cancelled) Cancelled
• Value date in the future, or without immediate settlement: Open -> Settled -> (only if cancelled) Cancelled

For example, let's assume you decide to buy 10,000 EUR against USD at value SPOT. If you were to retrieve this transaction immediately afterward, it would be marked as Open as the settlement would take place in two banking days time (unless there are any holidays in between). If you retrieve that same transaction again on the same or a later date, it would be marked as Settled, as the money will have been debited and credited from your two currency accounts accordingly.