Convert foreign currencies

WorldFirst supports two types of foreign exchanges:

  • Spot FX: A spot exchange rate is the current foreign exchange rate at which one currency trades for another at a specific point in time. Simply put, it is the exchange rate "on the spot".
  • Forward FX: A forward exchange rate represents the price at which a currency will be bought or sold at a future date.

Type 1. Spot FX trading

The following figure illustrates the workflow to create a spot FX trade request with WorldFirst:

image

Figure 1. Trade spot FX with WorldFirst APIs

Step1. Ensure funding is sufficient

Before initiating an FX trade with spot exchange rates, the Customer needs to make deposits to an assigned Virtual Account.

After receiving the deposits, WorldFirst notifies the Partner with the notifyVostro interface. The Partner needs to determine which specific Customer and which specific trade to process.

Step2. Create a FX quote

Call createQuote API to create an FX quote. WorldFirst responds with the quote.

Step 3. Create a spot FX settlement

You can create a spot FX settlement after retrieving a feasible quote, make sure the Customer has sufficient funding deposit.

  • You can also make active inquiries about the spot FX settlement result.

Step 4. Further actions

After the trade is completed, you can perform further actions such as making a transfer request.

Type 2. Forward FX trading

To trade forward FX, take the following steps:

Create a forward deal

Create a forward deal, which is an agreement to settle the forward FX at a future date. The following figure illustrates the workflow to create a forward deal with WorldFirst:

image

Figure 2. Create a forward deal with WorldFirst APIs

Step 1. Query an available date for the forward deal

The Customer submits an FX request with forward rates. To process the request, you need to book an available date for the forward deal. Call the inquiryAvailableCalendar API for an available date on the calendar. Return the available date to the Customer for confirmation.

Step 2. Create a quote for the forward deal

Call the createQuote API to create a foreign exchange quote. WorldFirst responds with the quote.

Step 3. Create a forward deal

After the quote is confirmed by the Customer, you can create a forward deal.

  • The forward deal process is asynchronous. WorldFirst responds that the forward deal is being processed. For the forward deal result, you can actively make an inquiry.

Step 4. Receive forward deal result notification

Once WorldFirst finishes processing the forward deal, you will receive a notification about the forward deal result. You need to acknowledge the reception of the notification and process the result accordingly.

Execute a forward settlement to settle the deal

Execute a forward settlement to settle the deal. You need to ensure the deal is sufficiently funded before the settlement. The following figure illustrates the workflow to create a forward settlement with WorldFirst:

image

Figure 3. Create a forward settlement with WorldFirst APIs

Step 5. (Optional) Unwind a forward deal

In case you need to cancel the forward deal, call the unwindDeal API. WorldFirst cancels the forward deal and returns the cancellation result to the Partner.

Step 6. Ensure funding is sufficient

Once the forward deal is due to be concluded, you need to settle the forward deal by creating a forward settlement.

Before making a forward settlement, the Customer needs to make deposits to an assigned Virtual Account.

After receiving the deposits, WorldFirst notifies the Partner with the notifyVostro interface. The Partner needs to determine which specific Customer and which specific forward settlement to process.

Step 7. Create a forward settlement

Once you have verified that the Customer has made sufficient funding deposits, a forward settlement can be initiated.

  • The settlement process is asynchronous. WorldFirst responds that the settlement is being processed. For the settlement result, you can actively query the settlement result.

Step 8. Receive settlement result notification

WorldFirst sends out the settlement result notification after the settlement is concluded.

More information:

  • After receiving the notification, you must take the corresponding actions to process the notification. You need to acknowledge the reception of the notification and process the result accordingly.

Step 9. Further actions

After the trade is completed, you can perform further actions such as making a transfer request.

@2024 WorldFirst