Guides & Tutorials
Jenga API
Forex Rates
Get Forex Rates

Get Forex Rates

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates

The Foreign Exchange Rates API Provides Easy Access To The Equity Bank Daily Currency Conversion Rate For Major Currencies

200 Success Response Schema

Field NameField TypeField Descriptions
dataobjectlist of conversion rates for major currencies
convertedAmountdoubleConverted amount
ratedoubleConversion rate
fromAmountdoubleOriginal amount
rateCodestring

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula
countryCode+currencyCode+amount+toCurrency
Example Request
curl -X POST \
	-d '{
            "accountNumber": "1450160649886",
            "countryCode": "KE",
            "currencyCode": "GBP",
            "amount": 344,
            "toCurrency": "USD"
        }'  \
	-H 'Authorization: Bearer {{token}}'  \
	-H 'Content-Type: application/json'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates'

Example Response

Example Response
{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "convertedAmount": 425.184,
        "rate": 1.236,
        "fromAmount": 344,
        "rateCode": "TTB"
    }
}