Transacciones

En resumen
Cada depósito, retiro, intercambio o barrido que fluye a través de Blockradar crea un registro de transacción. La API de Transacciones es tu registro de actividad — úsala para consultar historial, investigar pagos específicos, reenviar webhooks perdidos, cancelar transacciones pendientes o reintentar las fallidas.

Requisitos Previos

Clave API

Obtén tu clave API desde el Dashboard de Blockradar. Ve a Desarrolladores para generar una.

Billetera Creada

Necesitarás un walletId para consultar transacciones. Crea uno en el dashboard (consulta Crear una billetera principal).

Cómo Funciona

Cuando ocurre cualquier evento on-chain en una billetera Blockradar — un depósito entrante, un retiro enviado, un barrido activado — Blockradar crea un registro de transacción y dispara un webhook. La API de Transacciones te da acceso programático a todos estos registros.

Consultar Historial

Recupera todas las transacciones de una billetera o filtra por dirección, activo, estado o rango de fechas.

Investigar Pagos

Busca una transacción específica por ID para verificar su estado, hash y metadatos.

Reenviar Webhooks

Reenvía un webhook para una transacción que tu sistema pudo haber perdido o fallado en procesar.

Cancelar o Reintentar

Cancela una transacción pendiente atascada o reintenta una fallida sin reenviar desde cero.

Estados de Transacción

Estado	Descripción
`PENDING`	Transacción enviada a la blockchain, esperando confirmación
`SUCCESS`	Transacción confirmada y liquidada
`FAILED`	Transacción fallida on-chain o rechazada
`CANCELLED`	Transacción cancelada antes de ser transmitida

Consultar Transacciones

Obtener todas las transacciones de una billetera

GET /v1/wallets/{walletId}/transactions

Puedes filtrar por dirección, activo, tipo, estado y rango de fechas usando parámetros de consulta.

Obtener una sola transacción

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

Ejemplo

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 un Webhook Perdido

Si tu sistema perdió o no pudo procesar un webhook, puedes solicitar un reenvío sin esperar otro evento on-chain.

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

Esto es útil para flujos de reconciliación y para recuperarse de tiempos de inactividad.

Cancelar una Transacción Pendiente

Si una transacción está atascada en PENDING y aún no ha sido transmitida, puedes cancelarla.

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

La cancelación solo es posible antes de que la transacción sea transmitida a la blockchain. Una vez que está on-chain, no se puede cancelar.

Reintentar una Transacción Fallida

Si una transacción falló por gas insuficiente o un problema temporal del nodo, puedes reintentarla.

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

Mejores Prácticas

Usa webhooks como señal principal — no consultes la API de Transacciones para actualizaciones en tiempo real. Úsala para reconciliación, investigaciones e historial.
Almacena los IDs de transacción — guarda el ID de transacción de Blockradar junto a tus registros internos para poder consultar su estado en cualquier momento.
Reenvía webhooks después de tiempo de inactividad — si tu endpoint de webhook no estaba disponible, usa el endpoint de reenvío para recuperar eventos perdidos en lugar de reprocesarlos manualmente.

Referencia de API

Endpoint	Descripción
Obtener Transacciones	Consultar todas las transacciones de una billetera
Obtener Transacción	Consultar una transacción por ID
Reenviar Webhook	Reenviar un webhook para una transacción
Activar Barrido de Activos	Activar un barrido manualmente
Cancelar Transacción	Cancelar una transacción pendiente
Reintentar Transacción	Reintentar una transacción fallida

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Requisitos Previos

Cómo Funciona

Consultar Historial

Investigar Pagos

Reenviar Webhooks

Cancelar o Reintentar

Estados de Transacción

Consultar Transacciones

Obtener todas las transacciones de una billetera

Obtener una sola transacción

Ejemplo

Reenviar un Webhook Perdido

Cancelar una Transacción Pendiente

Reintentar una Transacción Fallida

Mejores Prácticas

Referencia de API

​Requisitos Previos

​Cómo Funciona

Consultar Historial

Investigar Pagos

Reenviar Webhooks

Cancelar o Reintentar

​Estados de Transacción

​Consultar Transacciones

​Obtener todas las transacciones de una billetera

​Obtener una sola transacción

​Ejemplo

​Reenviar un Webhook Perdido

​Cancelar una Transacción Pendiente

​Reintentar una Transacción Fallida

​Mejores Prácticas

​Referencia de API

Requisitos Previos

Cómo Funciona

Estados de Transacción

Consultar Transacciones

Obtener todas las transacciones de una billetera

Obtener una sola transacción

Ejemplo

Reenviar un Webhook Perdido

Cancelar una Transacción Pendiente

Reintentar una Transacción Fallida

Mejores Prácticas

Referencia de API