> ## Documentation Index
> Fetch the complete documentation index at: https://developer.nomba.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Convert Money

> Calculate a currency conversion before initiating a transfer

<Card title="Convert Money" icon="arrows-rotate" href="/nomba-api-reference/global-payout/convert-money" />

# `POST /v1/global-payout/money/convert`

When moving funds across currencies, Convert Money calculates the converted amount for you. Call this endpoint when you need to know the destination amount for a source amount before authorizing a transfer. The exchange rate and applicable fees are automatically scoped to the region configured for your authenticated account.

<CodeGroup>
  ```bash Request theme={null}
  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"
    }'
  ```

  ```json Response theme={null}
  {
    "code": "00",
    "description": "Successful",
    "status": false,
    "data": {
      "fromAmount": 15.0,
      "fromCurrency": "USD",
      "fromFormatted": "$15.00",
      "toAmount": 13.04,
      "toCurrency": "EUR",
      "toFormatted": "13,04 €",
      "spreadAmount": 0.12,
      "spreadCurrency": "EUR",
      "exchangeRateId": "01kkk4b7rh8pcvtw1s1nxs144s",
      "currencyPairName": "EUR/USD",
      "feeAmount": 0.0,
      "feeCurrency": "USD",
      "feeExpression": ""
    }
  }
  ```
</CodeGroup>

<Note>
  Convert Money is available only for supported currency corridors. Call [Fetch Exchange Rates](/docs/products/global-payout/fetch-exchange-rates) first to confirm that the pair is available. If a corridor is unavailable, the API returns an error asking you to contact support.
</Note>

#### Request body

<ParamField body="amount" type="number" required>
  The amount to convert in the source currency.
</ParamField>

<ParamField body="currency" type="string" required>
  The ISO 4217 currency code of the source amount (e.g., `USD`).
</ParamField>

<ParamField body="destinationCurrency" type="string" required>
  The ISO 4217 currency code to convert into (e.g., `EUR`).
</ParamField>

<ParamField body="transactionType" type="string" required>
  The type of transaction. Use `EXCHANGE` for currency conversions.
</ParamField>

#### Response body

<ResponseField name="fromAmount" type="number" required>
  The original amount in the source currency.
</ResponseField>

<ResponseField name="fromCurrency" type="string" required>
  The source currency code.
</ResponseField>

<ResponseField name="fromFormatted" type="string">
  The source amount formatted as a display string (e.g., `$15.00`).
</ResponseField>

<ResponseField name="toAmount" type="number" required>
  The converted amount in the destination currency.
</ResponseField>

<ResponseField name="toCurrency" type="string" required>
  The destination currency code.
</ResponseField>

<ResponseField name="toFormatted" type="string">
  The destination amount formatted as a display string.
</ResponseField>

<ResponseField name="spreadAmount" type="number">
  The spread amount applied to the conversion.
</ResponseField>

<ResponseField name="spreadCurrency" type="string">
  The currency the spread is denominated in.
</ResponseField>

<ResponseField name="exchangeRateId" type="string" required>
  The ID of the exchange rate used for this conversion. To have a transfer use the rate quoted to your customer, use the `exchangeRateId` returned by [Fetch Exchange Rates](/docs/products/global-payout/fetch-exchange-rates) as `lockedExchangeRateId` in Authorize Transfer.
</ResponseField>

<ResponseField name="currencyPairName" type="string">
  The currency pair notation (e.g., `EUR/USD`).
</ResponseField>

<ResponseField name="feeAmount" type="number">
  Any applicable transaction fee.
</ResponseField>

<ResponseField name="feeCurrency" type="string">
  The currency the fee is charged in.
</ResponseField>