Cotação FIAT para Crypto

Este endpoint permite calcular antecipadamente quanto o cliente receberá em Crypto ao depositar um valor específico em moeda fiduciária.

Utilize esta rota para exibir uma "prévia" ou cotação em tempo real na tela do seu usuário antes que ele confirme a geração do pedido de depósito.

---

Endpoint

• Método: POST

URL do Endpoint

https://api.xgateglobal.com/deposit/conversion/tether

---

Testar Integração

Utilize o formulário abaixo para simular uma conversão. O sistema irá buscar automaticamente os dados da moed e calcular quanto renderia em Crypto.

💱

Testar: Cotação para Conversão

1. Suas Credenciais

Email

Senha

---

2. Dados da Simulação

Valor em BRL para simular:

---

Requisição

É necessário enviar o Header de autenticação e o corpo JSON com o valor e o objeto da moeda.

Headers Obrigatórios

Header	Valor	Descrição
Authorization	Bearer <seu_token>	O token JWT obtido no login.

Body (Corpo da Requisição)

Campo	Tipo	Obrigatório	Descrição
amount	number	Sim	Valor em FIAT que se deseja converter.
currency	object	Sim	O objeto da moeda FIAT, obtido na rota de listagem de moedas.

---

Respostas (Responses)

Sucesso (200 OK)

Retorna o valor convertido, a sigla da cripto e a taxa de câmbio utilizada no momento.

{
  "amount": 0.186433,
  "crypto": "USDT",
  "fiatToCryptoExchangeRate": "R$ 5.364"
}

Erros Comuns

Status	Mensagem	Motivo Provável
401	Unauthorized	• Token inválido ou expirado. • Header inválido ou não informado. • IP não permitido.
500	Internal Server Error	Erro interno de servidor. Entrar em contato com suporte.

---

Como usar

Esta rota não gera um pedido de pagamento, ela serve apenas para consulta.

O Fluxo Recomendado (UX)

1. Input: O usuário digita "R$ 100,00" no seu app/site.
2. Consulta: Seu sistema chama POST /deposit/conversion/tether enviando o valor 100 e o objeto da moeda BRL.
3. Exibição: A API retorna que isso equivale a 18.64 USDT. Você exibe: "Você receberá aproximadamente 18.64 USDT".
4. Ação: Se o usuário concordar, aí sim você chama a rota de Criar Pedido de Depósito (POST /deposit).

Exemplo Prático

Siga os passos abaixo para realizar a cotação

1. Passo: Insira o valor em BRL para a cotação:

{
  "amount": 100,
  "currency": {
    "_id": "6728cba3******************",
    "name": "BRL",
    "type": "PIX",
    "createdDate": "2024-11-04T16:04:50.019Z",
    "updatedDate": "2024-11-07T02:23:38.606Z",
    "__v": 0,
    "symbol": "R$"
  }
}

2. Passo: Você deve buscar e injetar o objeto da moeda dentro de currency:

{
  "amount": 100,
  "currency": {
    "_id": "6728cba3******************",
    "name": "BRL",
    "type": "PIX",
    "createdDate": "2024-11-04T16:04:50.019Z",
    "updatedDate": "2024-11-07T02:23:38.606Z",
    "__v": 0,
    "symbol": "R$"
  }
}

Você pode obter a lista de moedas clicando aqui.

---

Integração

Node.js

O exemplo de integração utiliza a biblioteca Axios em Node.js.

Instalando Axios:

npm install axios

Exemplo Javascript:

const axios = require("axios");

(async () => {
    const email = "your_email@domain.com";
    const password = "**********";
    const amount = 10.90;

    try {
        const url_api = "https://api.xgateglobal.com"
        const login = await axios.post(`${url_api}/auth/token`, { email, password });
        const currencies = await axios.get(`${url_api}/deposit/company/currencies`, {
            headers: {
                "Authorization": `Bearer ${login.data.token}`
            }
        });
        const { data } = await axios.post(`${url_api}/deposit/conversion/tether`, {
            amount,
            currency: currencies.data[0]
        }, {
            headers: {
                "Authorization": `Bearer ${login.data.token}`
            }
        });
        console.log(data); // Response
    } catch (error) {
        console.log(error.response.data.message) // Error
    }
})()