Rate Bounds

Get the best and worst rates

Unlike the Rate endpoint, this GET endpoint is responsible for getting the best and worst rates for a supplied currency pair. This requires your app's publickey in the header while the query params passed will be the payInCurrencyCode , recieveInCurrencyCode & orderAmount.

The returned result will have bestRate and worstRate objects containing different rates. To get a response for a sell or swap order, switch to desired networks and currency inputs on request and make the call. See the example below;

Get the best and worst rates

GET https://checkout-api-sandbox.xendbridge.com/api/ThirdPartyUI/RateBounds

Query Parameters

Name	Type	Description
payInCurrencyCode*	string	NGN
payInCurrencyNetwork*	string	LOCAL
receiveInCurrencyCode*	string	BUSD
receiveInCurrencyNetwork*	string	BEP20
orderAmount*	double	500

Headers

Name	Type	Description
publicKey*	string	{publicKey}

200: OK Success

{
    "data": {
        "fiatCurrency": "NGN",
        "fiatCurrencyNetwork": "LOCAL",
        "cryptoCurrency": "BUSD",
        "cryptoCurrencyNetwork": "BEP20",
        "bestRate": {
            "exchangeRate": 757.89,
            "maximumAmount": 100000.000000000,
            "minimumAmount": 5.000000000,
            "providerRateReference": "E69A5099089F4231882C5A98B294B50F",
            "rateValidityInSeconds": 20
        },
        "worstRate": {
            "exchangeRate": 763.59,
            "maximumAmount": 100000.000000000,
            "minimumAmount": 5.000000000,
            "providerRateReference": "E69A5099089F4231882C5A98B294B50F",
            "rateValidityInSeconds": 20
        }
    },
    "status": "OK",
    "message": ""
}

Request Fields

Parameters	Type	Definitions
payInCurrencyCode	string	Required The currency to be paid in.
payInCurrencyNetwork	string	Required The network of the currency to be paid in
receiveInCurrencyCode	string	Required The currency to be received in.
receiveInCurrencyNetwork	string	Required The network of the currency to be received in
orderAmount	double	Required The amount of the order.

Response Fields

Parameters	Type	Definitions
exchangeRate	decimal	This is the exchange rate at which an order could be exchanged for
maximumAmount	decimal	This is the maximum amount a customer can order.
minimumAmount	decimal	This is the minimum amount a customer can order.
providerRateReference	string	This is the reference of the rates of a provider.
rateValidityInSeconds	int	This is the validity of an order rate of a provider in seconds.Rate Bounds