Held Rates
Lock in an exchange rate for up to 24 hours to manage your intraday and holiday currency exposure
Request a Held Rate
Begin by requesting a quote via the POST quotes/held-rate endpoint. You can choose a tenor of up to 24 hours.
If you don't convert the quote to a trade via the POST trades/held-rate endpoint before the expiry date/time, you will need to specify in the PostExpiryActionfield what action to take.
| PostExpiryAction Value | Description |
|---|---|
| Reject | Cannot use the quote anymore, trade request will be rejected. |
| AcceptAtSpot | Proceed with the trade, using spot value if the market is open. If the market is closed, trade request will be rejected. |
| UtiliseNextAvailableQuote | Multiple active quotes are allowed at the same time or to overlap. Should there be another open held rate quote, it will be used for the trade. If there are no other active quotes, trade request will be rejected. |
| ExecuteAtMarketOpen | Execute trade at spot value when the maket opens. |
When requesting a rate, you will need to pass in the estimated amount you expect to trade.
Book a Trade
To accept the quote and book the trade, you will need to pass back the QuoteID through the POST trades/held-rate endpoint.
When booking the trade, include the actual amount you would like to book. This does not have to be the same as the quoted amount.
The request to the book held rate endpoint will need to be made within the time that the quote is valid. This will begin when the quote is made.
When the booking request is made, if the quote is valid, you will receive a successful response.
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.
Retrieve all active Held Rate Quotes
You will be able to request multiple held rate quotes during the same timeframe.
To retrieve all active quotes, use the GET quotes/held-rate endpoint.
Updated 3 months ago