Vendendo criptomoedas

Este endpoint permite vender criptomoedas e receber o valor em reais na conta. A operação pode ser simulada ou executada de forma real.

📍 Endpoint

POST https://api.etherglobalassets.com.br/exchange/sell

🧾 Cabeçalhos obrigatórios (Headers)

🧰 Corpo da Requisição (JSON)

{
  "amount": 0.135,
  "token": "USDT",
  "network": "Polygon",
  "isSimulation": true
}

Explicação dos campos:

Tokens Suportados:

Redes Suportadas:

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/exchange/sell \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 3.7377,
    "token": "USDT",
    "network": "Polygon",
    "isSimulation": true
  }'

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido e ajuste os valores conforme necessário.

✅ Resposta esperada (HTTP 200 - OK)

{
  "success": true,
  "orderId": "619866ab-a9db-466b-9b05-64a42593163e",
  "amount": 3.7377,
  "currentPrice": 5.346,
  "grossAmount": 19.98,
  "totalFees": 0.15,
  "netAmount": 19.83,
  "token": "USDT",
  "network": "Polygon",
  "isSimulation": false,
  "newBalance": 2307,
  "transactionId": "4570f973-d5aa-43d1-8331-d33bff596d8f",
  "message": "Sale processed successfully! Net amount of R$ 19,83 has been credited to your account and is available for use."
}

Explicação da resposta:

⚠️ Possíveis erros

🎯 Como usar a venda de criptomoedas

Após receber a resposta, você pode:

1. Simular primeiro: Use isSimulation: true para ver os valores sem executar

2. Verificar preços: Use currentPrice e grossAmount para validar os valores

3. Confirmar taxas: Verifique o campo totalFees para entender os custos

4. Executar venda: Use isSimulation: false para realizar a venda real

5. Acompanhar resultado: Verifique o campo success e leia a message de retorno

💰 Cálculo de valores

• Quantidade de tokens: O campo amount deve ser enviado em unidades da criptomoeda

• Valor recebido: Use netAmount para saber exatamente quanto foi creditado

• Taxas: O campo totalFees já engloba todas as taxas da plataforma e rede

• Exemplo: amount: 3.7377 USDT = R$ 19,83 (líquido creditado)

🛡️ Limitações e restrições

✅ FAÇA:

• Sempre simule primeiro com isSimulation: true

• Verifique se tem saldo suficiente da criptomoeda

• Use tokens suportados (BTC, ETH, USDC, USDT)

• Confirme os valores antes de executar a venda real

❌ NÃO FAÇA:

• Usar valores acima do saldo disponível

• Ignorar as taxas da operação

• Usar tokens não suportados

• Executar vendas sem simular primeiro

🆘 Problemas comuns

“Estou recebendo erro 400!”

• Verifique se o valor está dentro do saldo disponível

• Confirme se todos os campos obrigatórios estão preenchidos

• Verifique se o token é suportado

“A venda não foi concluída!”

• Verifique se success retornou false

• Leia o campo message para entender o motivo (ex: saldo insuficiente, erro na rede)

• Confirme se o saldo da criptomoeda é suficiente

“Erro 401!”

• Verifique se o token de autenticação é válido

• Faça uma nova autenticação se necessário

“Erro 403!”

• Verifique se o usuário tem permissão para vender criptomoedas

• Entre em contato com o suporte se necessário

📞 Suporte

Se nada funcionar:

1. Verifique o saldo da criptomoeda na conta

2. Confirme os valores estão corretos

3. Entre em contato com nossa equipe de suporte

Mais informações sobre o endpoint: