Consulta de criptomoedas associados a carteira

Este endpoint permite listar todos os ativos (criptomoedas) de uma carteira específica pelo seu endereço.

⚠️ IMPORTANTE - Regras Obrigatórias

🚨 AUTENTICAÇÃO: Todas as requisições DEVEM incluir um token JWT válido

📊 ENDEREÇO VÁLIDO: O endereço da carteira deve ser válido e existir no sistema

📍 Endpoint

GET https://api.etherglobalassets.com.br/criptobrokers/v1/wallet/assets/{address}

🧾 Cabeçalhos obrigatórios (Headers)

Cabeçalho	Valor	Descrição
Authorization	Bearer <token>	Token JWT de autenticação

🧰 Parâmetros de Caminho (Path Parameters)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
address	string	✅	Endereço da carteira	`0xabcdef1234567890abcdef1234567890abcdef12`

🧰 Parâmetros de Consulta (Query Parameters)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
network	string	❌	A rede da carteira	`mainnet`

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/wallet/assets/0xabcdef1234567890abcdef1234567890abcdef12?network=mainnet \
  --request GET \
  --header 'Authorization: Bearer <token>'

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido e <address> pelo endereço da carteira.

✅ Resposta esperada (HTTP 200 - OK)

{
  "assets": [
    {
      "id": "asset_123456789abcdef",
      "symbol": "USDT",
      "type": "TOKEN",
      "amount": "1.250000000000000000",
      "lockedAmount": "0",
      "identifier": "0x1234567890abcdef1234567890abcdef12345678",
      "walletId": "wallet_987654321fedcba",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:30.000Z",
      "network": "mainnet",
      "blockchain": "polygon",
      "walletAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
      "label": "CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012",
      "exchangeRate": "1.000000000000000000",
      "totalValue": {
        "type": "usd",
        "amount": 0
      }
    }
  ]
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
assets	array	Lista de ativos da carteira	`[...]`

Campos de cada ativo:

Campo	Tipo	Descrição	Exemplo
id	string	ID único do ativo	`"asset_123456789abcdef"`
symbol	string	Símbolo do ativo	`"USDT"`
type	string	Tipo do ativo	`"TOKEN"`
amount	string	Quantidade do ativo	`"1.250000000000000000"`
lockedAmount	string	Quantidade bloqueada do ativo	`"0"`
identifier	string	Identificador do token	`"0x1234567890abcdef1234567890abcdef12345678"`
walletId	string	ID da carteira	`"wallet_987654321fedcba"`
createdAt	string	Data de criação	`"2024-01-15T10:30:00.000Z"`
updatedAt	string	Data de atualização	`"2024-01-20T14:45:30.000Z"`
network	string	Rede da blockchain	`"mainnet"`
blockchain	string	Blockchain do ativo	`"polygon"`
walletAddress	string	Endereço da carteira	`"0xabcdef1234567890abcdef1234567890abcdef12"`
label	string	Rótulo da carteira	`"CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012"`
exchangeRate	string	Taxa de câmbio	`"1.000000000000000000"`
totalValue	object	Valor total em USD	`{"type": "usd", "amount": 0}`

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	Endereço de carteira inválido
401	Unauthorized	Token inválido ou ausente
500	Internal Server Error	Erro interno do serviço

🎯 Como usar a consulta de ativos por endereço

Após receber a resposta, você pode:

Verificar saldos: Use amount para ver o saldo de cada ativo
Identificar tokens: Use symbol e type para identificar os ativos
Verificar bloqueios: Use lockedAmount para ver valores bloqueados
Analisar valores: Use totalValue para valores em USD
Verificar taxas: Use exchangeRate para taxas de câmbio

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Use endereços válidos de carteira
Verifique a rede correta
Analise todos os ativos retornados
Confirme os valores antes de usar

❌ NÃO FAÇA:

Ignorar a autenticação
Usar endereços inválidos
Ignorar a rede especificada
Assumir valores sem verificar

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se o endereço da carteira é válido
Confirme se o token é válido
Verifique se a carteira existe no sistema

“Erro 401!”

Verifique se o token de autenticação é válido
Faça uma nova autenticação se necessário

“Lista vazia!”

Verifique se a carteira tem ativos
Confirme se o endereço está correto
Verifique se a rede está correta

📞 Suporte

Se nada funcionar:

Verifique se o endereço da carteira é válido
Confirme se o token de autenticação é válido
Verifique se a carteira existe e tem ativos
Entre em contato com nossa equipe de suporte

Mais Informações sobre esse endpoint:

Acesse aqui