Spot
Book an FX trade at the current exchange rate.
Request a Quote
To commence the booking process you will need to request a quote using the spot quote endpoint.
The quote is only valid for 10 seconds. During this period, a decision will need to be made on whether or not to book it. After the 10 seconds elapse, the quote will be invalidated.
💭 The quote endpoint incorporates multiple permission and limit checks. A successful quote will only be returned if the trade is within agreed limits, including available balance, below maximum trade size and your daily limit has not been exceeded.
If all the permission checks are successful, the Executed response will be returned.
The value date for spot can be same day (T+0), next day (T+1) or spot (T+2). This is provided that the cut-off time has not passed.
Please ensure the value date requested is valid. If the value date requested is not in a valid format, an error will be returned and you will need to make a new request with the correct value date parameter.
If you are unsure what value date to provide, you can use our trade settlement date endpoint to get the earliest value date.
If the requested value date is not accepted by the bank, we will dynamically adjust it to ensure the trade is executed.
Book a Spot Trade
To accept a quote and book a trade, you will need to pass in the QuoteID through to the spot trade endpoint.
As all the necessary permission checks have been conducted in the previous step, all that needs to be done now is the request to book.
⏰ The request to book will need to be made within the 10 seconds that the quote is valid for. The quote will become invalid after 10 seconds.
Once the book API request has reached Alpha and the quote is validated, you will receive a successful response with the trade showing as Executed.
After this point, should you wish to cancel the trade, you would need to contact your account manager. Cancelling would require booking an equal and opposite trade which may incur a financial loss.
Updated 29 days ago