Skip to main content

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. 
curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/exchange-rates?from=EUR&to=USD' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'
The exchangeRateId in the response is a locked rate identifier. Pass it as lockedExchangeRateId in your Authorize Transfer request to guarantee the transaction is fulfilled at the exact rate you quoted to your customer. Exchange rates are updated periodically — locking the rate prevents any movement between quote time and execution.

​
Query parameters

​
from
string
required
The ISO 4217 currency code to convert from (e.g., EUR).
​
to
string
required
The ISO 4217 currency code to convert to (e.g., USD).
​
region
string
Optional trade region filter. Defaults to the account’s configured region.

​
Response body

​
rates
array
required
A list of exchange rate objects for the requested currency pair.