Obtendo cotação de uma criptomoeda

Obtendo cotação de uma criptomoeda específica

Este endpoint permite consultar o preço atualizado de um ativo específico (ex: BTC, ETH, USDT ou USDC). Ele retorna o valor unitário e também uma versão formatada para exibição direta em Reais (BRL).

📍 Endpoint

GET https://api.etherglobalassets.com.br/exchange/quote/{asset}

🧾 Cabeçalhos (Headers)

[!NOTE] Este endpoint é público e não requer autenticação via JWT.

🧰 Parâmetros da Requisição

📌 Exemplo com curl

curl "https://api.etherglobalassets.com.br/exchange/quote/BTC?amount=1" \
  --request GET

✅ Resposta esperada (HTTP 200 - OK)

{
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "networks": ["Bitcoin"],
  "image": "https://static.coinall.ltd/cdn/...",
  "decimals": 8,
  "price": 64037300,
  "formattedPrice": "R$ 640.373,00"
}

Explicação da Resposta:

• price: Valor bruto em centavos. Para cálculos matemáticos, utilize este campo.

• formattedPrice: Uma string pronta para ser exibida no seu sistema, já convertida para Reais e formatada.

• decimals: Exibe a precisão decimal nativa do ativo na blockchain.

💰 Cálculo de Preços

[!IMPORTANT] ⚠️ Atenção ao Valor: Embora o campo formattedPrice seja conveniente para exibição, para cálculos internos de ordens, utilize o campo price e divida por 100 para obter o valor unitário real em BRL.

⚠️ Possíveis erros

🛡️ Boas Práticas

✅ FAÇA:

• Certifique-se de enviar o código do ativo sempre em caixa alta (UPPERCASE).

• Utilize a imagem retornada no campo image para manter a identidade visual dos ativos constante em sua plataforma.

❌ NÃO FAÇA:

• ⚠️ Cache Prolongado: O mercado cripto oscila a cada segundo. Não armazene este valor por mais de 15 segundos para evitar discrepâncias nas ordens dos usuários.

Suporte Técnico

Para consultar limites de compra e venda baseados nestas cotações, consulte a documentação de Listagem Geral de Cotações.