Obtendo todas as transações de criptomoedas

Este endpoint permite listar todas as transações 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/transactions/list

🧾 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`

Valores para orderBy:

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

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/transactions/list?page=1&limit=10&orderBy=asc \
  --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)

{
  "page": 1,
  "limit": 10,
  "orderBy": "asc",
  "totalItems": 25,
  "totalPages": 3,
  "items": [
    {
      "id": "txn_123456789abcdef",
      "walletId": "wallet_987654321fedcba",
      "typeAsset": "TOKEN",
      "type": "DEPOSIT",
      "amount": "1.250000000000000000",
      "externalRequestId": "req_123456789abcdef",
      "externalReferenceId": "ref_987654321fedcba",
      "senderAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
      "recipientAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "metadata": {},
      "symbol": "USDT",
      "tokenIdentifier": "0x1234567890abcdef1234567890abcdef12345678",
      "status": "PAID",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:30.000Z"
    }
  ]
}

Explicação da resposta:

Campo	Tipo	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 aplicada	`"asc"`
totalItems	number	Total de transações encontradas	`25`
totalPages	number	Total de páginas	`3`
items	array	Lista de transações	`[...]`

Campos de cada transação:

Campo	Tipo	Descrição	Exemplo
id	string	ID único da transação	`"txn_123456789abcdef"`
walletId	string	ID da carteira	`"wallet_987654321fedcba"`
typeAsset	string	Tipo do ativo	`"TOKEN"`
type	string	Tipo da transação	`"DEPOSIT"`
amount	string	Quantidade da transação	`"1.250000000000000000"`
externalRequestId	string	ID da requisição externa	`"req_123456789abcdef"`
externalReferenceId	string	ID da referência externa	`"ref_987654321fedcba"`
senderAddress	string	Endereço do remetente	`"0xabcdef1234567890abcdef1234567890abcdef12"`
recipientAddress	string	Endereço do destinatário	`"0x1234567890abcdef1234567890abcdef12345678"`
metadata	object	Metadados da transação	`{}`
symbol	string	Símbolo do ativo	`"USDT"`
tokenIdentifier	string	Identificador do token	`"0x1234567890abcdef1234567890abcdef12345678"`
status	string	Status da transação	`"PAID"`
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 transações

Após receber a resposta, você pode:

Navegar pelas páginas: Use page e totalPages para paginação
Verificar status: Use status para verificar o estado das transações
Analisar tipos: Use type e typeAsset para categorizar transações
Verificar valores: Use amount para análises financeiras
Rastrear transações: Use externalRequestId e externalReferenceId para rastreamento

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Use paginação para grandes volumes de dados
Verifique o status das transações
Analise os tipos de transação
Use ordenação para resultados consistentes

❌ NÃO FAÇA:

Ignorar a autenticação
Fazer requisições sem paginação para grandes volumes
Ignorar o status das transações
Processar todos os dados de uma vez

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se os parâmetros de paginação são válidos
Confirme se o token é válido
Use valores válidos para orderBy

“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 se disponíveis
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 paginação são válidos
Use paginação para grandes volumes
Entre em contato com nossa equipe de suporte

Mais informações sobre o endpoint:

Acesse aqui