Cotar conversão entre carteiras
Cria uma cotação temporária entre carteiras usando a cotação de mercado, o deságio global ou direcional e o spread comercial configurado para a empresa. Nenhum saldo é movimentado nesta etapa.
Endpoint
Esta operação usa autenticação por
x-api-key e retorna JSON.| Método | Endpoint |
|---|---|
POST | /api/v2/companies/{companyId}/wallets/conversions/quote |
Parâmetros
Parâmetros aceitos por esta operação.
| Parâmetro | Local | Descrição |
|---|---|---|
companyId | path | Identificador da empresa |
Corpo da requisição
Envie os campos abaixo com
Content-Type: application/json.Exiba marketRate, discountPercentage, localRate, spreadPercentage, appliedRate, destinationAmount e expiresAt antes da confirmação. Uma cotação expirada deve ser refeita.
{"sourceCurrency":"USDT","destinationCurrency":"BRL","sourceAmount":100}Exemplo de requisição
Use uma chave de idempotência única em operações POST.
curl --request POST \
--url 'https://api.leonapay.com.br/api/v2/companies/{companyId}/wallets/conversions/quote' \
--header 'Accept: application/json' \
--header 'x-api-key: {your_api_key}' \
--header 'Content-Type: application/json' \
--header 'idempotency-key: {uuid}' \
--data '{"sourceCurrency":"USDT","destinationCurrency":"BRL","sourceAmount":100}'Resposta
Uma operação aceita retorna o envelope padrão da API LeonaPay.
{"success":true,"leonapayCode":"LP200","data":{"sourceCurrency":"USDT","sourceAmount":100,"destinationCurrency":"BRL","destinationAmount":479.18,"marketRate":5.20,"discountPercentage":5,"localRate":4.94,"spreadPercentage":3,"appliedRate":4.7918,"expiresAt":1791115500000,"quoteToken":"eyJ..."}}