Listando carteiras

Este endpoint permite listar todas as carteiras com opções de filtro e paginação.

⚠️ IMPORTANTE - Regras Obrigatórias

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

📍 Endpoint

GET https://api.etherglobalassets.com.br/criptobrokers/v1/wallet

🧾 Cabeçalhos obrigatórios (Headers)

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

🧰 Parâmetros de Consulta (Query Parameters)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
page	number	❌	Número da página atual	`1`
limit	number	❌	Número de itens por página	`10`
orderBy	string	❌	Ordenação (asc/desc)	`asc`
id	string	❌	ID da carteira	`wallet_123456789abcdef`
managerId	string	❌	ID do gerente	`user_123456789abcdef`
ownerId	string	❌	ID do proprietário	`user_123456789abcdef`
tenantId	string	❌	ID do tenant	`tenant_123456789abcdef`
address	string	❌	Endereço da carteira	`0xabcdef1234567890abcdef1234567890abcdef12`
blockchain	string	❌	Blockchain da carteira	`ethereum`
network	string	❌	Rede da carteira	`mainnet`
label	string	❌	Rótulo da carteira	`CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012`
type	string	❌	Tipo de carteira	`CUSTOMER`

Valores para orderBy:

asc: Ordem ascendente (padrão)
desc: Ordem descendente

Blockchains Suportadas:

bitcoin
ethereum
polygon
tron

Tipos de Carteira:

MANAGER
CUSTOMER
ADMIN
TENANT
CLIENT

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/wallet?page=1&limit=10&blockchain=ethereum \
  --request GET \
  --header 'Authorization: Bearer <token>'

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

✅ Resposta esperada (HTTP 200 - OK)

{
  "totalItems": 4,
  "totalPages": 1,
  "limit": 10,
  "page": 1,
  "items": [
    {
      "id": "wallet_123456789abcdef",
      "network": "mainnet",
      "blockchain": "bitcoin",
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "type": "ADMIN",
      "label": "ADMIN-BITCOIN-MAINNET-12345678-1234-1234-1234-123456789012",
      "ownerId": "user_123456789abcdef",
      "vaultId": "vault_123456789abcdef",
      "addressForWithdraw": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "creationTracking": [
        "ADMIN",
        "user_123456789abcdef",
        "NOT_INFO",
        "user_987654321fedcba"
      ],
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:30.000Z"
    }
  ]
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
totalItems	number	Total de carteiras encontradas	`4`
totalPages	number	Total de páginas	`1`
limit	number	Limite de itens por página	`10`
page	number	Página atual	`1`
items	array	Lista de carteiras	`[...]`

Campos de cada carteira:

Campo	Tipo	Descrição	Exemplo
id	string	ID único da carteira	`"wallet_123456789abcdef"`
network	string	Rede da carteira	`"mainnet"`
blockchain	string	Blockchain da carteira	`"bitcoin"`
address	string	Endereço da carteira	`"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"`
type	string	Tipo da carteira	`"ADMIN"`
label	string	Rótulo da carteira	`"ADMIN-BITCOIN-MAINNET-12345678-1234-1234-1234-123456789012"`
ownerId	string	ID do proprietário	`"user_123456789abcdef"`
vaultId	string	ID do cofre	`"vault_123456789abcdef"`
addressForWithdraw	string	Endereço para saques	`"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"`
creationTracking	array	Rastreamento da criação	`["ADMIN", "user_123456789abcdef", "NOT_INFO", "user_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"`

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	Parâmetros inválidos
401	Unauthorized	Token inválido ou ausente
500	Internal Server Error	Erro interno do serviço

🎯 Como usar a listagem de carteiras

Após receber a resposta, você pode:

Navegar pelas páginas: Use page e totalPages para paginação
Filtrar resultados: Use os parâmetros de filtro disponíveis
Ordenar resultados: Use orderBy para ordenação
Contar resultados: Use totalItems para saber o total
Acessar carteiras: Use o id de cada carteira para operações específicas

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Use paginação para grandes volumes de dados
Aplique filtros para reduzir resultados
Verifique o total de itens antes de processar
Use ordenação para resultados consistentes

❌ NÃO FAÇA:

Ignorar a autenticação
Fazer requisições sem paginação para grandes volumes
Ignorar os filtros disponíveis
Processar todos os dados de uma vez

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se os parâmetros de filtro são válidos
Confirme se os valores de enum são corretos
Verifique se o token é válido

“Erro 401!”

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

“Muitos resultados!”

Use paginação com page e limit
Aplique filtros específicos
Use ordenação para resultados consistentes

📞 Suporte

Se nada funcionar:

Verifique se o token de autenticação é válido
Confirme se os parâmetros de filtro são válidos
Use paginação para grandes volumes
Entre em contato com nossa equipe de suporte

Mais Informações sobre esse endpoint:

Acesse aqui