Saltar al contenido principal
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

1

Clave API

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

Billetera Creada

Necesitarás un walletId para consultar transacciones.

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

EstadoDescripción
PENDINGTransacción enviada a la blockchain, esperando confirmación
SUCCESSTransacción confirmada y liquidada
FAILEDTransacción fallida on-chain o rechazada
CANCELLEDTransacción cancelada antes de ser transmitida

Consultar Transacciones

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

Reenviar un Webhook Perdido

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

Cancelar una Transacción Pendiente

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
La cancelación solo es posible antes de que la transacción sea transmitida a la blockchain.

Reintentar una Transacción Fallida

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 e investigaciones.
  • Almacena los IDs de transacción — guarda el ID de transacción de Blockradar junto a tus registros internos.
  • 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.

Referencia de API

EndpointDescripción
Obtener TransaccionesConsultar todas las transacciones de una billetera
Obtener TransacciónConsultar una transacción por ID
Reenviar WebhookReenviar un webhook
Cancelar TransacciónCancelar una transacción pendiente
Reintentar TransacciónReintentar una transacción fallida