> ## 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.

# Fetch exchange rates

> Retrieve the latest exchange rates for a currency pair before initiating a transfer.



## OpenAPI

````yaml get /v1/global-payout/exchange-rates
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/exchange-rates:
    get:
      description: >-
        Retrieve the latest exchange rates for a currency pair before initiating
        a transfer.
      operationId: Fetch Exchange Rates
      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
        - name: from
          in: query
          required: true
          description: ISO 4217 currency code to convert from.
          schema:
            type: string
            example: EUR
        - name: to
          in: query
          required: true
          description: ISO 4217 currency code to convert to.
          schema:
            type: string
            example: USD
        - name: region
          in: query
          required: false
          description: Optional trade region filter.
          schema:
            type: string
      responses:
        '200':
          description: Exchange rates retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: '00'
                  description:
                    type: string
                    example: Successful
                  data:
                    type: object
                    properties:
                      rates:
                        type: array
                        items:
                          type: object
                          properties:
                            exchangeRateId:
                              type: string
                              example: 01kkk7pab9mjt70wvk6pzk8mzx
                            currencyPairName:
                              type: string
                              example: EUR/USD
                            bidRate:
                              type: string
                              example: $1.13
                            askRate:
                              type: string
                              example: $1.14
                            midRate:
                              type: string
                              example: $1.14
                            createdAt:
                              type: string
                              example: '2026-03-13T09:15:57.161946'

````