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

# Fetch Exchange Rates

> Retrieve exchange rate between currency pairs



## OpenAPI

````yaml get /v3/fx/payout
openapi: 3.1.0
info:
  title: sandbox
  version: '3'
servers:
  - url: https://service-sandbox.tazapay.com
security:
  - sec0: []
paths:
  /v3/fx/payout:
    get:
      summary: Fetch Exchange Rates
      description: Retrieve exchange rate between currency pairs
      operationId: fetch-exchange-rates
      parameters:
        - name: initial_currency
          in: query
          description: ISO 4217 standard specifies three-letter ("Alpha-3") codes. e.g. USD
          required: true
          schema:
            type: string
        - name: final_currency
          in: query
          description: ISO 4217 standard specifies three-letter ("Alpha-3") codes. e.g. USD
          required: true
          schema:
            type: string
        - name: amount
          in: query
          description: >-
            Amount in cents. For example if you want to charge $10.12 pass 1012
            as the value. For decimal handling for various currencies, refer to
            the guide <a href='/decimal-currencies'>here</a>
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    status: success
                    message: ''
                    data:
                      amount: 100
                      converted_amount: 84902
                      exchange_rate: 84.90246799733201
                      final_currency: INR
                      initial_currency: USD
                      timestamp: '2025-01-09T09:51:40.229346267Z'
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      Indicates whether the FX conversion request was
                      successful.
                  message:
                    type: string
                    description: >-
                      Additional information about the FX conversion operation,
                      if any.
                  data:
                    type: object
                    description: >-
                      Contains detailed information about the currency
                      conversion result.
                    properties:
                      amount:
                        type: number
                        description: The amount that needs to be exchanged
                      converted_amount:
                        type: integer
                        description: >-
                          The amount converted into the final currency,
                          expressed in the smallest currency unit (e.g., cents).
                      exchange_rate:
                        type: number
                        description: >-
                          The exchange rate applied for converting from the
                          initial to the final currency.
                      final_currency:
                        type: string
                        description: >-
                          The target currency after conversion (ISO 4217
                          format).
                      initial_currency:
                        type: string
                        description: >-
                          The source currency before conversion (ISO 4217
                          format).
                      timestamp:
                        type: string
                        description: >-
                          Timestamp indicating when the FX conversion was
                          performed (ISO 8601 format).
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic

````