Em resumo
Cada depósito, saque, troca ou varredura que flui pelo Blockradar cria um registro de transação. A API de Transações é seu registro de atividade — use-a para buscar histórico, investigar pagamentos específicos, reenviar webhooks perdidos, cancelar transações pendentes ou retentar as que falharam.
Cada depósito, saque, troca ou varredura que flui pelo Blockradar cria um registro de transação. A API de Transações é seu registro de atividade — use-a para buscar histórico, investigar pagamentos específicos, reenviar webhooks perdidos, cancelar transações pendentes ou retentar as que falharam.
Pré-requisitos
Chave de API
Obtenha sua chave de API no Dashboard do Blockradar. Navegue até Desenvolvedores para gerar uma.
Como Funciona
Quando qualquer evento on-chain ocorre em uma carteira Blockradar — um depósito chegando, um saque sendo enviado, uma varredura sendo acionada — o Blockradar cria um registro de transação e dispara um webhook. A API de Transações dá acesso programático a todos esses registros.Buscar Histórico
Recupere todas as transações de uma carteira ou filtre por endereço, ativo, status ou intervalo de datas.
Investigar Pagamentos
Busque uma transação específica por ID para verificar seu status, hash e metadados.
Reenviar Webhooks
Reenvie um webhook para uma transação que seu sistema possa ter perdido ou falhado em processar.
Cancelar ou Retentar
Cancele uma transação pendente travada ou retente uma que falhou sem reenviar do zero.
Estados de Transação
| Status | Descrição |
|---|---|
PENDING | Transação enviada à blockchain, aguardando confirmação |
SUCCESS | Transação confirmada e liquidada |
FAILED | Transação falhou on-chain ou foi rejeitada |
CANCELLED | Transação cancelada antes de ser transmitida |
Consultando Transações
Reenviar um Webhook Perdido
Cancelar uma Transação Pendente
Retentar uma Transação com Falha
Melhores Práticas
- Use webhooks como sinal principal — não consulte a API de Transações para atualizações em tempo real. Use-a para reconciliação e investigações.
- Armazene os IDs de transação — salve o ID de transação do Blockradar junto aos seus registros internos.
- Reenvie webhooks após inatividade — se seu endpoint de webhook estava indisponível, use o endpoint de reenvio para recuperar eventos perdidos.
Referência de API
| Endpoint | Descrição |
|---|---|
| Obter Transações | Buscar todas as transações de uma carteira |
| Obter Transação | Buscar uma transação por ID |
| Reenviar Webhook | Reenviar um webhook |
| Cancelar Transação | Cancelar uma transação pendente |
| Retentar Transação | Retentar uma transação com falha |