Quote API

Update Quote (FXP to Local Nexus Gateway)
POST /v1/quote/{source_currency}/{destination_currency}
Path Parameters
Attribute
Type
Condition
Description
Source Currency
String
Mandatory
From Currency
Destination Currency
String
Mandatory
To Currency
Request Body
Attribute
Type
Condition
Description
Source Liquidity Provider
String
Mandatory
Liquidity Provider in the Source IPS
Destination Liquidity Provider
String
Mandatory
Liquidity Provider in the Destination IPS
Rate
String
Mandatory
Exchange rate offered
Public
Boolean
Mandatory
Boolean to indicate whether the rate is limited or publicly available
Timestamp
DateTime
Optional
Valid from timestamp
Allowed Source Bank
Array
Conditional
If Public is N, a finite list of banks allowed to query this rate
Source Bank ID
String
Conditional
BIC (or equivalent) of the Source Bank (repetitive)
Response Body
Attribute
Type
Condition
Description
Rate ID
UUID
Mandatory
Unique ID of the rate
Rates
Array
Mandatory
​
Rate
String
Mandatory
Rates for this currency pair currently being offered
Get Quote (Source Bank to Source Nexus Gateway)
GET /v1/quote/{source_currency}/{destination_currency}
Path Parameters
Attribute
Type
Condition
Description
Source Currency
String
Mandatory
Sender’s currency
Destination Currency
String
Mandatory
Recipient’s currency
Request Body
Attribute
Type
Condition
Description
Type
String
Mandatory
Best, List or Nominated
Nominated FX Provider ID
String
Conditional (mandatory if Type is Nominated)
ID of FXP in case of dedicated request
Response
Attribute
Type
Condition
Description
Rates
Array
Mandatory
​
Quote ID
UUID
Conditional
Unique quote ID
Rate
String
Conditional
Rate
FX Provider ID
String
Conditional
UUID of FXP
Source Liquidity Provider
String
Conditional
BIC (or equivalent) of the Source Liquidity Provider
Delete Quote (FX Provider to Local Nexus Gateway)
New quotes using the Update Quote will automatically overwrite old quotes, so Delete Quote is not usually needed. However, an FX Provider who has issued a private quote visible to specific banks may wish to retract that quote and could use Delete Quote to do so.
Deleted quotes will be set to expire 5 minutes after the delete request was received by Nexus.
Request
DELETE /v1/quote/{quote_id}
Request Body
Attribute
Type
Condition
Description
N/A
​
​
​
Response Body
Attribute
Type
Condition
Description
Quote ID
UUID
Mandatory
​
Expiry DateTime
ISODateTime
Mandatory
Timestamp when quote will expire
Webhook: InformQuote (Nexus Gateway to FXP)
https://<customerDefinedHost:Port>/webhook
This template will be triggered during the account validation process to inform the FX Provider of an FX quote being given to a Sender.
Request Body
Fields
Description
Type
Amount
The amount of the quote
String
Source Currency
The currency of the Source country
String
Destination Currency
The currency of the Destination country
String
Rate
The exchange rate for the payment
String
Quote ID
The unique ID of the original quote
UUID
Expiry Date Time
Timestamp until the quote is valid
ISODateTime

Last modified 1yr ago

Attribute	Type	Condition	Description
Source Currency	String	Mandatory	From Currency
Destination Currency	String	Mandatory	To Currency

Attribute	Type	Condition	Description
Source Liquidity Provider	String	Mandatory	Liquidity Provider in the Source IPS
Destination Liquidity Provider	String	Mandatory	Liquidity Provider in the Destination IPS
Rate	String	Mandatory	Exchange rate offered
Public	Boolean	Mandatory	Boolean to indicate whether the rate is limited or publicly available
Timestamp	DateTime	Optional	Valid from timestamp
Allowed Source Bank	Array	Conditional	If Public is N, a finite list of banks allowed to query this rate
Source Bank ID	String	Conditional	BIC (or equivalent) of the Source Bank (repetitive)

Fields	Description	Type
Amount	The amount of the quote	String
Source Currency	The currency of the Source country	String
Destination Currency	The currency of the Destination country	String
Rate	The exchange rate for the payment	String
Quote ID	The unique ID of the original quote	UUID
Expiry Date Time	Timestamp until the quote is valid	ISODateTime