> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Transacciones

> Consulta, monitorea y gestiona toda la actividad on-chain en tus billeteras

<Note>
  En resumen<br />
  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.
</Note>

## Requisitos Previos

<Steps>
  <Step title="Clave API">
    Obtén tu clave API desde el [Dashboard de Blockradar](https://dashboard.blockradar.co). Ve a **Desarrolladores** para generar una.
  </Step>

  <Step title="Billetera Creada">
    Necesitarás un `walletId` para consultar transacciones.
  </Step>
</Steps>

## 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.

<CardGroup cols={2}>
  <Card title="Consultar Historial" icon="clock-rotate-left">
    Recupera todas las transacciones de una billetera o filtra por dirección, activo, estado o rango de fechas.
  </Card>

  <Card title="Investigar Pagos" icon="magnifying-glass">
    Busca una transacción específica por ID para verificar su estado, hash y metadatos.
  </Card>

  <Card title="Reenviar Webhooks" icon="rotate">
    Reenvía un webhook para una transacción que tu sistema pudo haber perdido o fallado en procesar.
  </Card>

  <Card title="Cancelar o Reintentar" icon="arrow-rotate-left">
    Cancela una transacción pendiente atascada o reintenta una fallida sin reenviar desde cero.
  </Card>
</CardGroup>

## 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

```bash theme={null}
GET /v1/wallets/{walletId}/transactions
GET /v1/wallets/{walletId}/transactions/{transactionId}
```

## Reenviar un Webhook Perdido

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook
```

## Cancelar una Transacción Pendiente

```bash theme={null}
POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel
```

<Warning>
  La cancelación solo es posible antes de que la transacción sea transmitida a la blockchain.
</Warning>

## Reintentar una Transacción Fallida

```bash theme={null}
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

| Endpoint                                                                   | Descripción                                        |
| -------------------------------------------------------------------------- | -------------------------------------------------- |
| [Obtener Transacciones](/en/api-reference/transactions/get-transactions)   | Consultar todas las transacciones de una billetera |
| [Obtener Transacción](/en/api-reference/transactions/get-transaction)      | Consultar una transacción por ID                   |
| [Reenviar Webhook](/en/api-reference/transactions/resend-webhook)          | Reenviar un webhook                                |
| [Cancelar Transacción](/en/api-reference/transactions/cancel-transaction)  | Cancelar una transacción pendiente                 |
| [Reintentar Transacción](/en/api-reference/transactions/retry-transaction) | Reintentar una transacción fallida                 |