Become a client

Buy-Into Quote Creation

Quote creation is a request for a quote of a collection of currency pairs. What is returned is a valid quote with rates ready to be booked within provided expiration intervals.

Table - Quote Creation

Resource Template
                            
/quotes
                          
Http Method POST
Description Request for a quote of a collection of currency pairs.
Return will be a valid quote with rates ready to be booked within provided expiration interval.
 
At least one 'itemToQuote' should be submitted. There is a limit of 25 currency pairs per request.
If more are submitted, the request will be rejected with a 400 status.
 
Unique currency pairs should be submitted, if duplication is detected, the request will be rejected with 400 status.
 
'isAmountSettlement' is an optional parameter.
If not provided , quoted amount considered to be in Trade currency (default value set to false).
Input
                            
{ "customerId":"<customerId>",
"partnerReference", "<partner generated reference>", "itemsToQuote":[
{"amount": <amount in cents, integer value>,"isAmountSettlement":<true/false>,
 specifies if a provided amount is in trade (default) or settlement currency,
"settlementCurrency":"<currencyCode>","tradeCurrency":"<currencyCode>"}]}
                          
Output
                            
{"id":"<quoteId>","customerId":"<customerId>",
"partnerReference", "<partner generated reference>",
"expirationIntervalInSec":"<expirationInterval,integer value>",
"status" : "<quoteStatus>", "createdOn":"<timestamp>",
"lastUpdatedOn" : "<timestamp>","quotedItems":[{
 "tradeAmount":<amount, in cents, integer value>,
"settlementAmount":<amount, in cents, integer value>,
"settlementCurrency":"<currencyCode>",
"tradeCurrency":"<currencyCode>",
"isDirectRate":<true/false> specifies if a provided rate is direct
 (multiplied by trade amount should provide settlement amount, or
indirect - multiplied by settlement amount should provide trade amount,
"rate":"<rate value, float as string>","rateInverted":
"<rate inverted value, float as string>",
"decimalsDirect":"<number of decimals for a direct rate, integer value>
 - could be used for presentation purpose",
"decimalsIndirect":"<number of decimals for Indirect rate, integer value>
 - could be used for presentation purpose"}]}     

                          
Output (errors)
                            
400 Bad Request - if any of the input parameters is not valid