Exchange Rates API

Access real-time cross-currency exchange rates based on a specific country, simplifying international conversions.

API Version

Overview

The Exchange Rates API provides a simple way to get foreign exchange (FX) data for your applications. By specifying a country code, you receive a set of pre-calculated exchange rates between that country's local currency and major international currencies like USD, EUR, and GBP. This removes the need for manual cross-rate calculations.

Service for B2B Partners

This API is provided as a free, value-added service to all our authenticated B2B partners. There are no additional charges for using this endpoint.

How to Use the Rates

To convert an amount, simply multiply it by the appropriate rate from the response.

Example: To convert 100 EUR to CDF, use the EUR_CDF rate:
100 * rates.EUR_CDF.

Example: To convert 50,000 CDF to USD, use the CDF_USD rate:
50000 * rates.CDF_USD.

Get Country-Specific Rates

GET/api/v1/b2b/exchange/rates

Retrieves a set of exchange rates relevant to a specific country by providing its two-letter country code.

Test in Your Browser

You can quickly test this endpoint by pasting the following URL into your browser. Replace `<YOUR_API_KEY>` with your actual key.

cURL

https://api.cashpay-all.com/api/v1/b2b/exchange/rates?country=CD&apiKey=<YOUR_API_KEY>

For programmatic use, you must specify a country using the ?country=XX query parameter and provide your key in the Authorization header.

cURL

curl -X GET 'https://api.cashpay-all.com/api/v1/b2b/exchange/rates?country=CD' \
-H 'Authorization: Bearer <YOUR_API_KEY>'

Success Response for ?country=CD

JSON

{
  "success": true,
  "country": "CD",
  "local_currency": "CDF",
  "last_updated": "2025-09-06T19:47:08.000Z",
  "rates": {
    "USD_EUR": 0.925,
    "USD_CDF": 2870.00,
    "EUR_USD": 1.08,
    "EUR_CDF": 3100.00,
    "CDF_USD": 0.000351,
    "CDF_EUR": 0.000323
  }
}