Exchange Rates

Before initiating a swap request, you can look up the current exchange rate between two currencies using the Get Exchange Rates endpoint. This lets you display live rates to your users or calculate expected amounts ahead of the swap. The supported currencies include NGN (Nigerian Naira), USD (United States Dollars), GBP (Pounds Sterling), EUR (Euro).

Fetching an exchange rate

To retrieve the exchange rate for a currency pair, make a GET request to the Get Exchange Rates endpoint with the source and destination currency codes.

The required parameters are:

• from_currency: The 3-letter ISO 4217 code for the source currency (e.g. NGN).
• to_currency: The 3-letter ISO 4217 code for the destination currency (e.g. USD).

curl -X GET "https://atlas.tryduplo.com/api/v1/exchange-rate/fetch?from_currency=NGN&to_currency=USD" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Accept: application/json"

On a successful request, you should receive a response similar to the one below:

{
  "requestId": "3a6538fd-03f0-4b05-ba41-5d44769dd014",
  "requestTimestamp": "2026-02-20 10:15:30.123",
  "message": "Exchange rate retrieved successfully.",
  "statusCode": 200,
  "data": {
    "id": "b3a2e3ac-2744-4fb8-8f5f-49555f1637e1",
    "fromCurrency": "NGN",
    "toCurrency": "USD",
    "currentRate": 2050,
    "buyRate": 2040,
    "sellRate": 2050,
    "rateType": "partner",
    "partnerId": "8c5b077c-9b72-4dbf-b7d4-530d8e9b3985",
    "rateKind": "sell",
    "status": "active",
    "createdAt": "2026-02-20 10:15:30.123",
    "updatedAt": "2026-02-20 10:15:30.123"
  }
}

The currentRate field is the active exchange rate for the currency pair. The buyRate is the rate at which Atlas exchanges your local currency (e.g. NGN) into the destination currency (e.g. USD), while the sellRate is the rate at which Atlas sells the destination currency back to you in your local currency. The rateKind field specifies whether the returned rate is a buy or sell rate.

Related guides

• Single Payout
• Payout Workflow