Transações

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.

Pré-requisitos

Chave de API

Obtenha sua chave de API no Dashboard do Blockradar. Navegue até Desenvolvedores para gerar uma.

Carteira Criada

Você precisará de um walletId para consultar transações. Crie um no dashboard (veja Criar uma Carteira Principal).

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

Obter todas as transações de uma carteira

GET /v1/wallets/{walletId}/transactions

Você pode filtrar por endereço, ativo, tipo, status e intervalo de datas usando parâmetros de consulta.

Obter uma única transação

GET /v1/wallets/{walletId}/transactions/{transactionId}

Exemplo

const transactions = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/transactions?status=SUCCESS&limit=50`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log(transactions.data);

Reenviar um Webhook Perdido

Se seu sistema perdeu ou falhou em processar um webhook, você pode acionar um reenvio sem esperar por outro evento on-chain.

POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook

Isso é útil para fluxos de reconciliação e para se recuperar de períodos de inatividade.

Cancelar uma Transação Pendente

Se uma transação está travada em PENDING e ainda não foi transmitida, você pode cancelá-la.

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel

O cancelamento só é possível antes de a transação ser transmitida à blockchain. Depois que ela está on-chain, não pode ser cancelada.

Retentar uma Transação com Falha

Se uma transação falhou por gas insuficiente ou por um problema temporário de nó, você pode retentá-la.

POST /v1/wallets/{walletId}/transactions/{transactionId}/retry

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, investigações e histórico.
Armazene os IDs de transação — salve o ID de transação do Blockradar junto aos seus registros internos para poder consultar o status a qualquer momento.
Reenvie webhooks após inatividade — se seu endpoint de webhook estava indisponível, use o endpoint de reenvio para recuperar eventos perdidos em vez de reprocessá-los manualmente.

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 de uma transação
Acionar Varredura de Ativo	Acionar manualmente uma varredura
Cancelar Transação	Cancelar uma transação pendente
Retentar Transação	Retentar uma transação com falha

Começar

Carteiras

Receber Pagamentos

Enviar Pagamentos

Converter e Gerenciar

Conformidade e Recuperação

Integrações

Pré-requisitos

Como Funciona

Buscar Histórico

Investigar Pagamentos

Reenviar Webhooks

Cancelar ou Retentar

Estados de Transação

Consultando Transações

Obter todas as transações de uma carteira

Obter uma única transação

Exemplo

Reenviar um Webhook Perdido

Cancelar uma Transação Pendente

Retentar uma Transação com Falha

Melhores Práticas

Referência de API

​Pré-requisitos

​Como Funciona

Buscar Histórico

Investigar Pagamentos

Reenviar Webhooks

Cancelar ou Retentar

​Estados de Transação

​Consultando Transações

​Obter todas as transações de uma carteira

​Obter uma única transação

​Exemplo

​Reenviar um Webhook Perdido

​Cancelar uma Transação Pendente

​Retentar uma Transação com Falha

​Melhores Práticas

​Referência de API

Pré-requisitos

Como Funciona

Estados de Transação

Consultando Transações

Obter todas as transações de uma carteira

Obter uma única transação

Exemplo

Reenviar um Webhook Perdido

Cancelar uma Transação Pendente

Retentar uma Transação com Falha

Melhores Práticas

Referência de API