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

# Transações

> Busque, monitore e gerencie toda a atividade on-chain em suas carteiras

<Note>
  Em resumo<br />
  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.
</Note>

## Pré-requisitos

<Steps>
  <Step title="Chave de API">
    Obtenha sua chave de API no [Dashboard do Blockradar](https://dashboard.blockradar.co). Navegue até **Desenvolvedores** para gerar uma.
  </Step>

  <Step title="Carteira Criada">
    Você precisará de um `walletId` para consultar transações.
  </Step>
</Steps>

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

<CardGroup cols={2}>
  <Card title="Buscar Histórico" icon="clock-rotate-left">
    Recupere todas as transações de uma carteira ou filtre por endereço, ativo, status ou intervalo de datas.
  </Card>

  <Card title="Investigar Pagamentos" icon="magnifying-glass">
    Busque uma transação específica por ID para verificar seu status, hash e metadados.
  </Card>

  <Card title="Reenviar Webhooks" icon="rotate">
    Reenvie um webhook para uma transação que seu sistema possa ter perdido ou falhado em processar.
  </Card>

  <Card title="Cancelar ou Retentar" icon="arrow-rotate-left">
    Cancele uma transação pendente travada ou retente uma que falhou sem reenviar do zero.
  </Card>
</CardGroup>

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

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

## Reenviar um Webhook Perdido

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

## Cancelar uma Transação Pendente

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

<Warning>
  O cancelamento só é possível antes de a transação ser transmitida à blockchain.
</Warning>

## Retentar uma Transação com Falha

```bash theme={null}
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 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](/en/api-reference/transactions/get-transactions)     | Buscar todas as transações de uma carteira |
| [Obter Transação](/en/api-reference/transactions/get-transaction)       | Buscar uma transação por ID                |
| [Reenviar Webhook](/en/api-reference/transactions/resend-webhook)       | Reenviar um webhook                        |
| [Cancelar Transação](/en/api-reference/transactions/cancel-transaction) | Cancelar uma transação pendente            |
| [Retentar Transação](/en/api-reference/transactions/retry-transaction)  | Retentar uma transação com falha           |