Criando uma carteira

Este endpoint permite criar uma nova carteira de criptomoedas.

⚠️ IMPORTANTE - Regras Obrigatórias

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

📊 TIPOS DE CARTEIRA: Suporta diferentes tipos: MANAGER, CUSTOMER, ADMIN, TENANT, CLIENT

📍 Endpoint

POST 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
Content-Type	application/json	Formato do corpo da requisição

🧰 Corpo da Requisição (JSON)

{
  "network": "mainnet",
  "blockchain": "ethereum",
  "type": "CUSTOMER",
  "ownerId": "user_123456789abcdef",
  "tenantId": "tenant_987654321fedcba"
}

Explicação dos campos:

Campo	Tipo	Obrigatório	Descrição	Exemplo
network	string	✅	A rede para a carteira	“mainnet”
blockchain	string	✅	Blockchain da carteira	“ethereum”
type	string	✅	O tipo da carteira	“CUSTOMER”
ownerId	string	❌	ID do proprietário (para terceiros)	“user_123456789abcdef”
tenantId	string	❌	ID do tenant (para terceiros)	“tenant_987654321fedcba”

Redes Suportadas:

Rede	Descrição
mainnet	Rede principal
testnet	Rede de testes

Blockchains Suportadas:

Blockchain	Descrição
ethereum	Ethereum
bitcoin	Bitcoin
polygon	Polygon
tron	TRON

Tipos de Carteira:

Tipo	Descrição
MANAGER	Carteira de gerente
CUSTOMER	Carteira de cliente(exclusivo do Ether)
ADMIN	Carteira de administrador
TENANT	Carteira de tenant
CLIENT	Carteira de cliente do tenant

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/wallet \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "network": "mainnet",
    "blockchain": "ethereum",
    "type": "CUSTOMER"
  }'

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

✅ Resposta esperada (HTTP 201 - Created)

{
  "id": "wallet_123456789abcdef",
  "network": "mainnet",
  "blockchain": "ethereum",
  "type": "CUSTOMER",
  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
  "label": "CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-20T14:45:30.000Z",
  "customerId": "user_123456789abcdef",
  "managerId": "user_987654321fedcba",
  "tenantId": "tenant_123456789abcdef",
  "adminId": "user_abcdef123456789"
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
id	string	ID único da carteira	“wallet_123456789abcdef”
network	string	Rede da carteira	“mainnet”
blockchain	string	Blockchain da carteira	“ethereum”
type	string	Tipo da carteira	“CUSTOMER”
address	string	Endereço da carteira	“0xabcdef1234567890abcdef1234567890abcdef12”
label	string	Rótulo da carteira	“CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012”
createdAt	string	Data de criação	“2024-01-15T10:30:00.000Z”
updatedAt	string	Data de atualização	“2024-01-20T14:45:30.000Z”
customerId	string	ID do cliente	“user_123456789abcdef”
managerId	string	ID do gerente	“user_987654321fedcba”
tenantId	string	ID do tenant	“tenant_123456789abcdef”
adminId	string	ID do administrador	“user_abcdef123456789”

⚠️ Possíveis erros

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

🎯 Como usar a criação de carteiras

Após receber a resposta, você pode:

Armazenar o ID: Use o id retornado para futuras operações
Verificar o endereço: Use o address para transações
Confirmar o tipo: Use o type para verificar o tipo de carteira
Verificar a rede: Use o network e blockchain para confirmar a rede
Usar o rótulo: Use o label para identificação

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Verifique os parâmetros obrigatórios
Use tipos de carteira válidos
Confirme a rede e blockchain corretos
Armazene o ID da carteira criada

❌ NÃO FAÇA:

Ignorar a autenticação
Usar tipos de carteira inválidos
Usar redes inexistentes
Ignorar os parâmetros obrigatórios

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se todos os campos obrigatórios estão preenchidos
Confirme se o tipo de carteira é válido
Verifique se a rede e blockchain são suportados
Confirme 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

📞 Suporte

Se nada funcionar:

Verifique se todos os campos obrigatórios estão preenchidos
Confirme se o token de autenticação é válido
Verifique se os tipos de carteira são válidos
Entre em contato com nossa equipe de suporte

Mais Informações sobre esse endpoint:

Acesse aqui