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:
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:
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:
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.