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

# Obtenha uma cotação de câmbio

Este endpoint gera uma cotação de câmbio segura, fixando a taxa de câmbio, o prazo de validade e um token exclusivo para processamento de pagamentos. Por padrão, as cotações são atualizadas a cada 60 segundos, mas frequências personalizadas de um minuto a um dia estão disponíveis mediante solicitação para atender às suas necessidades operacionais.
\
&#x20;**Casos de uso suportados:**\
&#x20; \- **Payin (DCC)** : fixe a taxa antes de cobrar um pagamento do seu usuário.\
&#x20; \- **Payout (DCC)** : fixe a taxa antes de enviar um pagamento a um beneficiário.\
&#x20; \- **Bulk Exchange** : fixe a taxa antes de converter fundos entre as suas próprias contas.\
&#x20;  Para uma explicação completa de quando e por que usar cada opção, consulte [Visão geral de FX](https://docs.localpayment.com/pt-br/docs/fx-overview.md).


## OpenAPI

````yaml openapi/pt-br/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: Obtenha uma cotação de câmbio
      operationId: currency-exchange-quote
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: sourceCurrency
          in: query
          description: >-
            Moeda **da qual** você deseja converter. [Códigos de
            moeda](/pt-br/reference/currency-codes). As stablecoins USDC e USDT
            são suportadas.
          required: true
          schema:
            type: string
            examples:
              - ARS
        - name: quoteCurrency
          in: query
          description: >-
            Moeda **para a qual** você deseja converter. [Códigos de
            moeda](/pt-br/reference/currency-codes).
          required: true
          schema:
            type: string
            examples:
              - USD
        - name: accountNumber
          in: query
          description: >-
            Sua conta Localpayment que contém a **moeda de origem** (a conta a
            ser debitada). Deve ser diferente de `quoteAccountNumber`.
          required: true
          schema:
            type: string
            examples:
              - '{{accountNumber}}'
        - name: quoteAccountNumber
          in: query
          description: >-
            Sua conta Localpayment que contém a **moeda de destino** (a conta a
            ser creditada). Deve ser diferente de `accountNumber`.
          required: true
          schema:
            type: string
        - name: type
          in: path
          description: Tipo de transação.
          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 usado para rastrear e garantir a taxa de câmbio
                          em uma solicitação de pagamento.
                      transactionType:
                        type: string
                        enum:
                          - PayIn
                          - PayOut
                        description: Tipo de transação.
                      accountNumber:
                        type: string
                        description: Número da conta Localpayment.
                      sourceCurrency:
                        type: string
                        enum:
                          - ARS
                          - BOB
                          - BRL
                          - CLP
                          - COP
                          - CRC
                          - DOP
                          - USD
                          - GTQ
                          - MXN
                          - PYG
                          - PEN
                          - UYU
                          - USDC
                          - USDT
                        description: '[Moeda de origem](/pt-br/reference/currency-codes).'
                      creationDate:
                        type: string
                        description: Data de criação.
                      expirationDate:
                        type: string
                        description: Data de validade.
                      quotes:
                        type: array
                        description: Informações da cotação.
                        items:
                          type: object
                          properties:
                            paymentMethodCode:
                              type: string
                              description: >-
                                [Código do método de
                                pagamento](/pt-br/reference/get-available-payment-methods).
                            rate:
                              type: number
                              description: Taxa de cotação.
                            quoteCurrency:
                              type: string
                              enum:
                                - ARS
                                - BOB
                                - BRL
                                - CLP
                                - COP
                                - CRC
                                - DOP
                                - USD
                                - GTQ
                                - MXN
                                - PYG
                                - PEN
                                - UYU
                                - USDC
                                - USDT
                              description: '[Moeda](/pt-br/reference/currency-codes) cotada.'
                    required:
                      - exchangeRateToken
                      - transactionType
                      - accountNumber
                      - sourceCurrency
                      - creationDate
                      - expirationDate
                      - quotes
                  - type: object
                    properties:
                      Status:
                        type: integer
                        description: Código de erro.
                      Message:
                        type: string
                        description: Informações adicionais sobre o erro.
                      TraceId:
                        type: string
                        description: ID de rastreamento do erro.
                    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: Não autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Informações adicionais sobre a resposta.
                  code:
                    type: string
                    description: Código de status.
                  messages:
                    type: array
                    description: Lista de mensagens.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Classe Token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensagem com informações adicionais.
                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: Proibido
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: |
                      Informações adicionais sobre a resposta.
                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.