Fetch Exchange Rates

GET /v1/global-payout/exchange-rates

Before sending funds in a currency different from your base currency, use this endpoint to retrieve the latest exchange rates. This ensures your customers always see accurate, up-to-date conversion values before a transaction is confirmed. Rates are automatically scoped to the region configured for your authenticated account.

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/exchange-rates?from=EUR&to=USD' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Successful",
  "status": false,
  "data": {
    "rates": [
      {
        "exchangeRateId": "01kkk7pab9mjt70wvk6pzk8mzx",
        "currencyPairName": "EUR/USD",
        "bidRate": "$1.13",
        "askRate": "$1.14",
        "midRate": "$1.14",
        "tradeRegion": "",
        "tradeContext": "",
        "createdAt": "2026-03-13T09:15:57.161946",
        "updatedAt": ""
      }
    ]
  }
}

To have a cross-currency transfer use the rate you quoted to your customer, pass the exchangeRateId in the response as lockedExchangeRateId in your Authorize Transfer request.

Query parameters

string

required

The ISO 4217 currency code to convert from (e.g., EUR).

string

required

The ISO 4217 currency code to convert to (e.g., USD).

Response body

array

required

A list of exchange rate objects for the requested currency pair.

Hide rate object

string

The unique ID of this exchange rate. Pass it as lockedExchangeRateId in Authorize Transfer for the transfer to use this rate.

string

The currency pair in standard notation (e.g., EUR/USD).

string

The rate at which Nomba buys the base currency.

string

The rate at which Nomba sells the base currency.

string

The mid-market rate between the bid and ask.

string

The timestamp when this rate was recorded.

Introduction

Getting Started

Products

API Basics

Guides