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

# Obtén una cotización de divisas

Este endpoint genera una cotización segura de cambio de divisas, fijando el tipo de cambio, el plazo de validez y un token único para el procesamiento del pago. Por defecto, las cotizaciones se actualizan cada 60 segundos, pero se pueden configurar frecuencias personalizadas, desde un minuto hasta un día, para adaptarse a tus necesidades operativas.
\
&#x20;**Casos de uso admitidos:**\
&#x20; \- **Payin (DCC)** : fija el tipo de cambio antes de cobrar un pago a tu usuario.\
&#x20; \- **Payout (DCC)** : fija el tipo de cambio antes de enviar un pago a un beneficiario.\
&#x20; \- **Intercambio masivo** : fija el tipo de cambio antes de convertir fondos entre tus propias cuentas.\
&#x20;  Para obtener una explicación completa de cuándo y por qué usar cada opción, consulta [Descripción general de FX](https://docs.localpayment.com/es/docs/fx-overview.md).


## OpenAPI

````yaml openapi/es/localpayment.json GET /api/fx/currency-exchange/{type}
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/fx/currency-exchange/{type}:
    get:
      summary: Obtén una cotización de divisas
      operationId: currency-exchange-quote
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: sourceCurrency
          in: query
          description: >-
            Moneda **desde** la que deseas convertir. [Códigos de
            moneda](/es/reference/currency-codes). Se admiten las stablecoins
            USDC y USDT.
          required: true
          schema:
            type: string
            examples:
              - ARS
        - name: quoteCurrency
          in: query
          description: >-
            Moneda **a** la que deseas convertir. [Códigos de
            moneda](/es/reference/currency-codes).
          required: true
          schema:
            type: string
            examples:
              - USD
        - name: accountNumber
          in: query
          description: >-
            Tu cuenta de Localpayment que contiene la **moneda de origen** (la
            cuenta que se debitará). Debe ser diferente de `quoteAccountNumber`.
          required: true
          schema:
            type: string
            examples:
              - '{{accountNumber}}'
        - name: quoteAccountNumber
          in: query
          description: >-
            Tu cuenta de Localpayment que contiene la **moneda de destino** (la
            cuenta que se abonará). Debe ser diferente de `accountNumber`.
          required: true
          schema:
            type: string
        - name: type
          in: path
          description: Tipo de transacción.
          required: true
          schema:
            type: string
            enum:
              - payin
              - payout
              - CurrencyExchange
            examples:
              - payin
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                anyOf:
                  - type: object
                    properties:
                      exchangeRateToken:
                        type: string
                        description: >-
                          Token utilizado para rastrear y garantizar el tipo de
                          cambio en una solicitud de pago.
                      transactionType:
                        type: string
                        enum:
                          - PayIn
                          - PayOut
                        description: Tipo de transacción.
                      accountNumber:
                        type: string
                        description: Número de cuenta de Localpayment.
                      sourceCurrency:
                        type: string
                        enum:
                          - ARS
                          - BOB
                          - BRL
                          - CLP
                          - COP
                          - CRC
                          - DOP
                          - USD
                          - GTQ
                          - MXN
                          - PYG
                          - PEN
                          - UYU
                          - USDC
                          - USDT
                        description: '[Moneda de origen](/es/reference/currency-codes).'
                      creationDate:
                        type: string
                        description: Fecha de creación.
                      expirationDate:
                        type: string
                        description: Fecha de expiración.
                      quotes:
                        type: array
                        description: Información de la cotización.
                        items:
                          type: object
                          properties:
                            paymentMethodCode:
                              type: string
                              description: >-
                                [Código del método de
                                pago](/es/reference/get-available-payment-methods).
                            rate:
                              type: number
                              description: Tasa de cotización.
                            quoteCurrency:
                              type: string
                              enum:
                                - ARS
                                - BOB
                                - BRL
                                - CLP
                                - COP
                                - CRC
                                - DOP
                                - USD
                                - GTQ
                                - MXN
                                - PYG
                                - PEN
                                - UYU
                                - USDC
                                - USDT
                              description: '[Moneda](/es/reference/currency-codes) cotizada.'
                    required:
                      - exchangeRateToken
                      - transactionType
                      - accountNumber
                      - sourceCurrency
                      - creationDate
                      - expirationDate
                      - quotes
                  - type: object
                    properties:
                      Status:
                        type: integer
                        description: Código de error.
                      Message:
                        type: string
                        description: Información adicional del error.
                      TraceId:
                        type: string
                        description: ID de seguimiento del error.
                    required:
                      - Status
                      - Message
                      - TraceId
                x-examples:
                  Example 1:
                    exchangeRateToken: 978898c8-9162-4af0-a833-07959fe50d44
                    transactionType: PayIn
                    accountNumber: '{{sourceAccountNumber}}'
                    sourceCurrency: ARS
                    creationDate: '2024-12-27T21:20:39.4379138+00:00'
                    expirationDate: '2024-12-28T05:20:39.4379138+00:00'
                    quotes:
                      - paymentMethodCode: '1005'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1023'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1000'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1004'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1002'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                  Stablecoin (USDT):
                    accountNumber: '{{sourceAccountNumber}}'
                    creationDate: '2026-01-15T21:03:06.2722727Z'
                    exchangeRateToken: b4eb8276-8edc-43e6-937d-97ecd98ea902
                    expirationDate: '2026-01-15T21:14:06.2722727Z'
                    quotes:
                      - paymentMethodCode: null
                        quoteAccountNumber: '{{quoteAccountNumber}}'
                        quoteCurrency: USD
                        rate: 1
                    sourceCurrency: USDT
                    transactionType: CurrencyExchange
              examples:
                200 - Currency Exchange Quote.:
                  value:
                    exchangeRateToken: 5c3q89a7-f1bc-4ba5-a3b5-411ba0d144ca
                    transactionType: PayIn
                    accountNumber: '{{sourceAccountNumber}}'
                    sourceCurrency: ARS
                    creationDate: '2024-12-27T21:33:32.6513692+00:00'
                    expirationDate: '2024-12-28T05:33:32.6513692+00:00'
                    quotes:
                      - paymentMethodCode: '1005'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1023'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1000'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1004'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                      - paymentMethodCode: '1002'
                        rate: 0.0008369108482392735
                        quoteCurrency: USD
                404 - currency error.:
                  value:
                    Status: 404
                    Message: >-
                      Source currency is neither the local nor the account
                      currency for this
                    TraceId: 2a8f37c4-9f60-4436-bd16-d00c9d4ebe00
                403 - Source and quote currencies must be different.:
                  value:
                    Status: 403
                    Message: Source and quote currencies must be different
                    TraceId: 4a1fca4f-a57a-4503-a3c4-71cc5ce7af55
                404 - The quote currency does not exist:
                  value:
                    Status: 404
                    Message: The quote currency does not exist
                    TraceId: 46c82280-9a22-49cf5-bc7-e6da676e0594
                404 -The source currency does not exist.:
                  value:
                    Status: 404
                    Message: The source currency does not exist
                    TraceId: 90f599a3-c0ac-46aa-b4ee-edacb538d80b
                404 - This account doesn't have a PayOut configuration for this.:
                  value:
                    Status: 404
                    Message: This account doesn't have a PayOut configuration for this
                    TraceId: 080d56d1-496b-4661-87ac-75175ef55b31
                200 - FX Quote Stablecoin (USDT).:
                  value:
                    accountNumber: '{{sourceAccountNumber}}'
                    creationDate: '2026-01-15T21:03:06.2722727Z'
                    exchangeRateToken: b4eb8276-8edc-43e6-937d-97ecd98ea902
                    expirationDate: '2026-01-15T21:14:06.2722727Z'
                    quotes:
                      - paymentMethodCode: null
                        quoteAccountNumber: '{{quoteAccountNumber}}'
                        quoteCurrency: USD
                        rate: 1
                    sourceCurrency: USDT
                    transactionType: CurrencyExchange
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: |
                      Información adicional sobre la respuesta.
                required:
                  - detail
                x-examples:
                  Example 1:
                    detail: You do not have permission to perform this action.
              examples:
                403 - You do not have permission to perform this action.:
                  value:
                    detail: You do not have permission to perform this action.
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.