> ## 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 and lock an exchange rate before initiating a transfer.



## OpenAPI

````yaml post /v1/global-payout/money/convert
openapi: 3.0.1
info:
  description: ''
  title: Vendor API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.nomba.com
  - description: Sandbox
    url: https://sandbox.nomba.com
security: []
tags:
  - name: Authenticate
  - name: Accounts
  - name: Virtual Accounts
  - name: Online Checkout
  - name: Charge
  - name: Transfers
  - name: Direct Debits
  - name: Terminals
  - name: Transactions
  - name: Airtime and Data Vending
  - name: Electricity Vending
  - name: CableTV Subscription
  - name: Betting Vending
paths:
  /v1/global-payout/money/convert:
    post:
      description: >-
        Calculate a currency conversion and lock an exchange rate before
        initiating a transfer.
      operationId: Convert Money
      parameters:
        - description: Bearer token for authentication.
          in: header
          name: Authorization
          schema:
            type: string
            example: Bearer <token>
          required: true
        - description: The parent accountId of the business.
          in: header
          name: accountId
          schema:
            type: string
            example: 890022ce-bae0-45c1-9b9d-ee7872e6ca27
          required: true
      requestBody:
        required: true
        description: Currency conversion payload
        content:
          application/json:
            schema:
              type: object
              required:
                - amount
                - currency
                - destinationCurrency
                - transactionType
                - sourceCountryIsoCode
              properties:
                amount:
                  type: number
                  example: 15
                currency:
                  type: string
                  example: USD
                  description: ISO 4217 source currency code.
                destinationCurrency:
                  type: string
                  example: EUR
                  description: ISO 4217 destination currency code.
                transactionType:
                  type: string
                  example: EXCHANGE
                sourceCountryIsoCode:
                  type: string
                  example: NG
      responses:
        '200':
          description: Conversion calculated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: '00'
                  description:
                    type: string
                    example: Successful
                  data:
                    type: object
                    properties:
                      fromAmount:
                        type: number
                        example: 15
                      fromCurrency:
                        type: string
                        example: USD
                      fromFormatted:
                        type: string
                        example: $15.00
                      toAmount:
                        type: number
                        example: 13.04
                      toCurrency:
                        type: string
                        example: EUR
                      toFormatted:
                        type: string
                        example: 13,04 €
                      spreadAmount:
                        type: number
                        example: 0.12
                      spreadCurrency:
                        type: string
                        example: EUR
                      exchangeRateId:
                        type: string
                        example: 01kkk4b7rh8pcvtw1s1nxs144s
                      currencyPairName:
                        type: string
                        example: EUR/USD
                      feeAmount:
                        type: number
                        example: 0
                      feeCurrency:
                        type: string
                        example: USD

````