Obtendo cotação de uma criptomoeda

Este endpoint permite obter cotação de uma criptomoeda específica. Retorna o preço de compra para uma quantidade fixa de 10 unidades da criptomoeda.

📍 Endpoint

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

🧾 Cabeçalhos obrigatórios (Headers)

Este endpoint não requer autenticação.

🧰 Parâmetros da URL

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
asset	string	✅	Símbolo da criptomoeda	“BTC”

Criptomoedas Suportadas:

Símbolo	Nome	Descrição
BTC	Bitcoin	Primeira criptomoeda descentralizada
ETH	Ethereum	Plataforma de contratos inteligentes
USDT	Tether	Stablecoin atrelada ao dólar
USDC	USD Coin	Stablecoin regulamentada

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/exchange/quote/BTC \
  --request GET

✅ Dica: Este endpoint é público e não requer autenticação. Substitua BTC pela criptomoeda desejada.

✅ Resposta esperada (HTTP 200 - OK)

{
  "id": 1,
  "name": "Bitcoin",
  "symbol": "BTC",
  "networks": ["Bitcoin"],
  "image": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png",
  "decimals": 8,
  "price": 640373,
  "formattedPrice": "R$ 640.373,00"
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
id	number	ID único da criptomoeda	1
name	string	Nome da criptomoeda	“Bitcoin”
symbol	string	Símbolo da criptomoeda	“BTC”
networks	array	Redes suportadas para a criptomoeda	[“Bitcoin”]
image	string	URL da imagem da criptomoeda	"https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
decimals	number	Número de casas decimais	8
price	number	Preço atual da criptomoeda em centavos	640373
formattedPrice	string	Preço formatado em reais	“R$ 640.373,00”

⚠️ Possíveis erros

Código	Erro	Causa comum
404	Not Found	Criptomoeda não encontrada
500	Internal Server Error	Erro interno do serviço

🎯 Como usar a cotação

Após receber a resposta, você pode:

Obter preço atual: Use o campo price para cálculos precisos
Exibir preço formatado: Use formattedPrice para exibição ao usuário
Validar criptomoeda: Use id, name e symbol para identificação
Verificar redes: Use networks para validar compatibilidade
Calcular decimais: Use decimals para formatação correta

💰 Cálculo de preços

Preço em centavos: O campo price retorna o valor em centavos
Conversão para reais: Divida por 100 para obter o valor em reais
Preço formatado: Use formattedPrice para exibição direta
Exemplo: price: 640373 = R$ 6.403,73

📊 Exemplos para todas as criptomoedas

Bitcoin (BTC)

curl https://api.etherglobalassets.com.br/exchange/quote/BTC \
  --request GET

Ethereum (ETH)

curl https://api.etherglobalassets.com.br/exchange/quote/ETH \
  --request GET

Tether (USDT)

curl https://api.etherglobalassets.com.br/exchange/quote/USDT \
  --request GET

USD Coin (USDC)

curl https://api.etherglobalassets.com.br/exchange/quote/USDC \
  --request GET

🛡️ Limitações e restrições

✅ FAÇA:

Use o campo price para cálculos precisos
Use formattedPrice para exibição ao usuário
Verifique se a criptomoeda é suportada antes de fazer a requisição
Considere que os preços mudam frequentemente

❌ NÃO FAÇA:

Fazer cache dos preços por muito tempo
Usar valores de criptomoedas não suportadas
Ignorar o campo decimals na formatação
Assumir que o preço é fixo

🆘 Problemas comuns

“Estou recebendo erro 404!”

Verifique se o símbolo da criptomoeda está correto
Confirme se a criptomoeda é suportada (BTC, ETH, USDT, USDC)
Use apenas letras maiúsculas no símbolo

“O preço parece incorreto!”

Lembre-se que o preço está em centavos
Divida por 100 para obter o valor em reais
Use formattedPrice para exibição direta
Os preços são atualizados frequentemente

“Como formatar o preço corretamente?”

Use o campo formattedPrice para exibição
Para cálculos, use price e divida por 100
Considere o campo decimals para precisão

📞 Suporte

Se nada funcionar:

Confirme o símbolo da criptomoeda está correto
Entre em contato com nossa equipe de suporte

Mais Informações sobre esse endpoint:

Acesse aqui