Obtendo o saldo da conta da sua conta​

Este endpoint permite consultar o saldo atual da conta do usuário autenticado, retornando o valor disponível em tempo real.

Requisição

curl https://api.etherglobalassets.com.br/account-balance \
  --header 'Authorization: Bearer <token>'

Parâmetros:

• Header

  • Authorization: Token de acesso no formato Bearer <token>.

Respostas Possíveis

✅ 200 - Sucesso
Retorna o saldo atual da conta em BRL (R$).

{
  "balance": 100
}

🔒 401 - Acesso Não Autorizado
Token inválido, expirado ou ausente.

{
  "success": false,
  "message": "Unauthorized access"
}

⚠️ 500 - Erro Interno do Servidor
Falha inesperada durante a consulta.

{
  "success": false,
  "message": "Internal server error"
}

Exemplo de Uso Prático

1. Autentique-se para obter o Access Token.

2. Envie a requisição e trate a resposta:

   • Se 200, exiba o saldo formatado (ex.: R$ 100,00).

   • Se 401, renove o token e tente novamente.

Dicas:

• Para atualizações em tempo real, combine este endpoint com webhooks de transações.

• O saldo reflete valores líquidos (já descontadas taxas, se aplicáveis).

Exemplo em Python (opcional):

import requests

url = "https://api.etherglobalassets.com.br/account-balance"
headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)
if response.status_code == 200:
    print(f"Saldo atual: R$ {response.json()['balance']:.2f}")
else:
    print("Erro:", response.json())

Observações:

• O valor de balance pode ser negativo em casos de limite especial ou pendências.

• Para contas em outras moedas, o campo currency será adicionado em futuras versões.

Mais informações sobre o endpoint: