Skip to main content

Convert Money

​
POST /v1/global-payout/money/convert

When moving funds across currencies, ConvertMoney handles the conversion for you. Call this endpoint whenever a transaction requires a currency switch, and it will return the converted amount and a locked exchange rate ID to use when authorizing the transfer. 
curl --request POST \
  --url https://api.nomba.com/v1/global-payout/money/convert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountId>' \
  --data '{
    "amount": 15,
    "currency": "USD",
    "destinationCurrency": "EUR",
    "transactionType": "EXCHANGE",
    "sourceCountryIsoCode": "NG"
  }'

​
Request body

​
amount
number
required
The amount to convert in the source currency.
​
currency
string
required
The ISO 4217 currency code of the source amount (e.g., USD).
​
destinationCurrency
string
required
The ISO 4217 currency code to convert into (e.g., EUR).
​
transactionType
string
required
The type of transaction. Use EXCHANGE for currency conversions.
​
sourceCountryIsoCode
string
required
ISO 3166-1 alpha-2 country code of the sender (e.g., NG).

​
Response body

​
fromAmount
number
required
The original amount in the source currency.
​
fromCurrency
string
required
The source currency code.
​
fromFormatted
string
The source amount formatted as a display string (e.g., $15.00).
​
toAmount
number
required
The converted amount in the destination currency.
​
toCurrency
string
required
The destination currency code.
​
toFormatted
string
The destination amount formatted as a display string.
​
spreadAmount
number
The spread amount applied to the conversion.
​
spreadCurrency
string
The currency the spread is denominated in.
​
exchangeRateId
string
required
A locked exchange rate ID. Pass this when authorizing the transfer to guarantee the quoted rate.
​
currencyPairName
string
The currency pair notation (e.g., EUR/USD).
​
feeAmount
number
Any applicable transaction fee.
​
feeCurrency
string
The currency the fee is charged in.